#***************************************************************************
#                                  _   _ ____  _
#  Project                     ___| | | |  _ \| |
#                             / __| | | | |_) | |
#                            | (__| |_| |  _ <| |___
#                             \___|\___/|_| \_\_____|
#
# Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
#
# This software is licensed as described in the file COPYING, which
# you should have received as part of this distribution. The terms
# are also available at https://curl.se/docs/copyright.html.
#
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
# copies of the Software, and permit persons to whom the Software is
# furnished to do so, under the terms of the COPYING file.
#
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
# KIND, either express or implied.
#
# SPDX-License-Identifier: curl
#
###########################################################################
# by Tetetest and Sukender (Benoit Neil)

# Note: By default this CMake build script detects the version of some
# dependencies using `check_symbol_exists`. Those checks do not work in
# the case that both CURL and its dependency are included as sub-projects
# in a larger build using `FetchContent`. To support that case, additional
# variables may be defined by the parent project, ideally in the "extra"
# find package redirect file:
# https://cmake.org/cmake/help/latest/module/FetchContent.html#integrating-with-find-package
#
# The following variables are available:
#   HAVE_SSL_SET0_WBIO: `SSL_set0_wbio` present in OpenSSL
#   HAVE_OPENSSL_SRP: `SSL_CTX_set_srp_username` present in OpenSSL
#   HAVE_GNUTLS_SRP: `gnutls_srp_verifier` present in GnuTLS
#   HAVE_SSL_SET_QUIC_USE_LEGACY_CODEPOINT: `SSL_set_quic_use_legacy_codepoint` present in OpenSSL/wolfSSL
#   HAVE_QUICHE_CONN_SET_QLOG_FD: `quiche_conn_set_qlog_fd` present in quiche
#   HAVE_ECH: ECH API checks for OpenSSL, BoringSSL, wolfSSL or rustls-ffi
#
# For each of the above variables, if the variable is DEFINED (either
# to ON or OFF), the symbol detection is skipped.  If the variable is
# NOT DEFINED, the symbol detection is performed.

# 设置 CMake 最低和最高兼容版本，若版本不满足则报错
cmake_minimum_required(VERSION 3.7...3.16 FATAL_ERROR)
# 输出当前使用的 CMake 版本信息
message(STATUS "Using CMake version ${CMAKE_VERSION}")

# 收集命令行参数，用于生成 buildinfo.txt 文件
# 此代码必须位于脚本顶部以确保按预期工作
set(_cmake_args "")
# 检查环境变量 CURL_BUILDINFO、CURL_CI 或 CI 是否存在
if(NOT "$ENV{CURL_BUILDINFO}$ENV{CURL_CI}$ENV{CI}" STREQUAL "")
  # 获取所有缓存变量
  get_cmake_property(_cache_vars CACHE_VARIABLES)
  # 遍历所有缓存变量
  foreach(_cache_var IN ITEMS ${_cache_vars})
    # 获取当前缓存变量的帮助信息
    get_property(_cache_var_helpstring CACHE ${_cache_var} PROPERTY HELPSTRING)
    # 检查帮助信息是否为命令行指定变量的默认信息
    if(_cache_var_helpstring STREQUAL "No help, variable specified on the command line.")
      # 获取当前缓存变量的类型
      get_property(_cache_var_type CACHE ${_cache_var} PROPERTY TYPE)
      # 获取当前缓存变量的值
      get_property(_cache_var_value CACHE ${_cache_var} PROPERTY VALUE)
      # 若变量类型未初始化，则清空类型信息
      if(_cache_var_type STREQUAL "UNINITIALIZED")
        set(_cache_var_type)
      else()
        # 否则，添加类型前缀
        set(_cache_var_type ":${_cache_var_type}")
      endif()
      # 将命令行参数添加到 _cmake_args 变量中
      string(APPEND _cmake_args " -D${_cache_var}${_cache_var_type}=\"${_cache_var_value}\"")
    endif()
  endforeach()
endif()

# 将自定义 CMake 模块路径添加到搜索路径中
set(CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/CMake" ${CMAKE_MODULE_PATH})
# 包含自定义工具函数文件
include(Utilities)
# 包含自定义宏定义文件
include(Macros)
# 包含 CMake 依赖选项模块
include(CMakeDependentOption)
# 包含检查 C 编译器标志的模块
include(CheckCCompilerFlag)

# 从 curlver.h 文件中读取包含 LIBCURL_VERSION 或 LIBCURL_VERSION_NUM 的行
file(STRINGS "${CMAKE_CURRENT_SOURCE_DIR}/include/curl/curlver.h" _curl_version_h_contents REGEX "#define LIBCURL_VERSION( |_NUM )")
# 提取 LIBCURL_VERSION 定义的版本字符串
string(REGEX MATCH "#define LIBCURL_VERSION \"[^\"]*" _curl_version ${_curl_version_h_contents})
# 去除版本字符串的前缀，只保留版本号
string(REGEX REPLACE "[^\"]+\"" "" _curl_version ${_curl_version})
# 提取 LIBCURL_VERSION_NUM 定义的版本号
string(REGEX MATCH "#define LIBCURL_VERSION_NUM 0x[0-9a-fA-F]+" _curl_version_num ${_curl_version_h_contents})
# 去除版本号的前缀，只保留十六进制数值
string(REGEX REPLACE "[^0]+0x" "" _curl_version_num ${_curl_version_num})
# 清除中间变量
unset(_curl_version_h_contents)

# 输出 curl 的版本信息
message(STATUS "curl version=[${_curl_version}]")

# 从完整版本号中提取语义化版本号（X.Y.Z 格式）
string(REGEX REPLACE "([0-9]+\.[0-9]+\.[0-9]+).+" "\\1" _curl_version_sem "${_curl_version}")
# 定义项目名称、版本和使用的编程语言
project(CURL
  VERSION "${_curl_version_sem}"
  LANGUAGES C)

# 处理 CMake 无法准确识别某些目标的问题，手动调整配置
if(WINDOWS_STORE AND MINGW)  # mingw UWP 构建
  # CMake（截至 v3.31.2）会混淆并将 MSVC rc.exe 命令行模板应用于 windres
  # 通过 'Modules/Platform/Windows-windres.cmake' 将其重置为 windres 模板
  set(CMAKE_RC_COMPILE_OBJECT "<CMAKE_RC_COMPILER> -O coff <DEFINES> <INCLUDES> <FLAGS> <SOURCE> <OBJECT>")
elseif(WIN32 AND WINCE AND CMAKE_C_COMPILER_ID STREQUAL "GNU")  # mingw32ce 构建
  # 检查是否设置了 MINGW32CE_LIBRARY_DIR 变量
  if(NOT MINGW32CE_LIBRARY_DIR)
    message(FATAL_ERROR "Set MINGW32CE_LIBRARY_DIR variable to the mingw32ce platform library directory.")
  endif()

  # 标记为 MINGW 和 MINGW32CE 环境
  set(MINGW 1)
  set(MINGW32CE 1)

  # 构建带有 libcurl DLL 的导入库，复制自 CMake 的 'Modules/Platform/Windows-GNU.cmake'
  set(CMAKE_C_CREATE_SHARED_LIBRARY "<CMAKE_C_COMPILER> <CMAKE_SHARED_LIBRARY_C_FLAGS> <LANGUAGE_COMPILE_FLAGS> <LINK_FLAGS>")
  string(APPEND CMAKE_C_CREATE_SHARED_LIBRARY " <CMAKE_SHARED_LIBRARY_CREATE_C_FLAGS> -o <TARGET> -Wl,--out-implib,<TARGET_IMPLIB>")
  string(APPEND CMAKE_C_CREATE_SHARED_LIBRARY " ${CMAKE_GNULD_IMAGE_VERSION} <OBJECTS> <LINK_LIBRARIES>")

  # 构建资源文件，复制自 CMake 的 'Modules/Platform/Windows-windres.cmake'
  set(CMAKE_RC_COMPILE_OBJECT "<CMAKE_RC_COMPILER> -O coff <DEFINES> <INCLUDES> <FLAGS> <SOURCE> <OBJECT>")
  # 启用 RC 语言支持
  enable_language(RC)

  # CMake 默认设置为 '-fPIC'，会混淆工具链并导致构建失败，清除该选项
  set(CMAKE_C_COMPILE_OPTIONS_PIC "")

  # 设置静态库、共享库和导入库的前缀和后缀
  set(CMAKE_STATIC_LIBRARY_PREFIX "lib")
  set(CMAKE_STATIC_LIBRARY_SUFFIX ".a")
  set(CMAKE_SHARED_LIBRARY_PREFIX "lib")
  set(CMAKE_SHARED_LIBRARY_SUFFIX ".dll")
  set(CMAKE_IMPORT_LIBRARY_PREFIX "lib")
  set(CMAKE_IMPORT_LIBRARY_SUFFIX ".dll.a")
  set(CMAKE_FIND_LIBRARY_PREFIXES "lib" "")
  set(CMAKE_FIND_LIBRARY_SUFFIXES ".dll.a" ".a" ".lib")
elseif(DOS AND CMAKE_C_COMPILER_ID STREQUAL "GNU")  # DJGPP
  # 设置静态库的前缀和后缀
  set(CMAKE_STATIC_LIBRARY_PREFIX "lib")
  set(CMAKE_STATIC_LIBRARY_SUFFIX ".a")
  # 设置查找库的前缀和后缀
  set(CMAKE_FIND_LIBRARY_PREFIXES "lib")
  set(CMAKE_FIND_LIBRARY_SUFFIXES ".a")
endif()

# 当使用 CMake 内置的 Android 配置时，填充平台级别变量
if(ANDROID AND NOT DEFINED ANDROID_PLATFORM_LEVEL AND NOT CMAKE_SYSTEM_VERSION EQUAL 1)
  set(ANDROID_PLATFORM_LEVEL "${CMAKE_SYSTEM_VERSION}")
endif()

# 初始化目标标志变量
set(_target_flags "")
# 根据不同平台和编译器添加相应的标志
if(APPLE)
  string(APPEND _target_flags " APPLE")
endif()
if(UNIX)
  string(APPEND _target_flags " UNIX")
endif()
if(BSD)
  string(APPEND _target_flags " BSD")
endif()
if(ANDROID)
  string(APPEND _target_flags " ANDROID-${ANDROID_PLATFORM_LEVEL}")
endif()
if(WIN32)
  string(APPEND _target_flags " WIN32")
endif()
if(WINCE)
  string(APPEND _target_flags " WINCE")
endif()
if(WINDOWS_STORE)
  string(APPEND _target_flags " UWP")
endif()
if(CYGWIN)
  string(APPEND _target_flags " CYGWIN")
endif()
if(DOS)
  string(APPEND _target_flags " DOS")
endif()
if(AMIGA)
  string(APPEND _target_flags " AMIGA")
endif()
if(CMAKE_C_COMPILER_ID STREQUAL "GNU")
  string(APPEND _target_flags " GCC")
endif()
if(MINGW)
  string(APPEND _target_flags " MINGW")
endif()
if(MSVC)
  string(APPEND _target_flags " MSVC-${MSVC_VERSION}")
endif()
if(VCPKG_TOOLCHAIN)
  string(APPEND _target_flags " VCPKG")
endif()
if(CMAKE_CROSSCOMPILING)
  string(APPEND _target_flags " CROSS")
endif()
# 输出 CMake 平台标志信息
message(STATUS "CMake platform flags:${_target_flags}")

# 若为交叉编译，输出交叉编译信息
if(CMAKE_CROSSCOMPILING)
  message(STATUS "Cross-compiling: "
    "${CMAKE_HOST_SYSTEM_NAME}/${CMAKE_HOST_SYSTEM_PROCESSOR} -> "
    "${CMAKE_SYSTEM_NAME}/${CMAKE_SYSTEM_PROCESSOR}")
endif()

# 设置 CURL_OS 变量，优先使用 C 编译器目标信息
if(CMAKE_C_COMPILER_TARGET)
  set(CURL_OS "\"${CMAKE_C_COMPILER_TARGET}\"")
else()
  set(CURL_OS "\"${CMAKE_SYSTEM_NAME}\"")
endif()

# 添加项目头文件目录到包含路径
include_directories("${PROJECT_SOURCE_DIR}/include")

# 若未定义 CMake 统一构建批处理大小，设置为 0
if(NOT DEFINED CMAKE_UNITY_BUILD_BATCH_SIZE)
  set(CMAKE_UNITY_BUILD_BATCH_SIZE 0)
endif()

# 处理 CMAKE_TRY_COMPILE_TARGET_TYPE 为 STATIC_LIBRARY 导致的检测问题
# 当使用 'ios.toolchain.cmake' 时，默认会设置为 STATIC_LIBRARY，可能导致检测到不存在的特性
if(CMAKE_TRY_COMPILE_TARGET_TYPE STREQUAL "STATIC_LIBRARY")
  message(STATUS "CMAKE_TRY_COMPILE_TARGET_TYPE was found set to STATIC_LIBRARY. "
    "Overriding with EXECUTABLE for feature detections to work.")
  # 保存原始值
  set(_cmake_try_compile_target_type_save ${CMAKE_TRY_COMPILE_TARGET_TYPE})
  # 将其设置为 EXECUTABLE 以确保特性检测正常工作
  set(CMAKE_TRY_COMPILE_TARGET_TYPE "EXECUTABLE")
endif()

# 定义 CMake 选项
option(CURL_WERROR "Turn compiler warnings into errors" OFF)
option(PICKY_COMPILER "Enable picky compiler options" ON)
option(BUILD_CURL_EXE "Build curl executable" ON)
option(BUILD_SHARED_LIBS "Build shared libraries" ON)
option(BUILD_STATIC_LIBS "Build static libraries" OFF)
option(BUILD_STATIC_CURL "Build curl executable with static libcurl" OFF)
option(ENABLE_ARES "Enable c-ares support" OFF)
option(CURL_DISABLE_INSTALL "Disable installation targets" OFF)

# 检查当前是否为 Windows 平台
if(WIN32)
  # 定义一个 CMake 选项，用于控制是否使用 Windows API 函数的 Unicode 版本，默认关闭
  option(ENABLE_UNICODE "Use the Unicode version of the Windows API functions" OFF)
  # 检查是否为 Windows Store 应用或 Windows CE 平台
  if(WINDOWS_STORE OR WINCE)
    # 若为 Windows Store 应用或 Windows CE 平台，强制启用 Unicode 支持
    set(ENABLE_UNICODE ON)
  endif()
  # 若启用了 Unicode 支持
  if(ENABLE_UNICODE)
    # 为当前目录添加编译定义，启用 Unicode 相关宏
    set_property(DIRECTORY APPEND PROPERTY COMPILE_DEFINITIONS "UNICODE" "_UNICODE")
    # 检查是否使用 MinGW 编译器且不是 MinGW32CE 环境
    if(MINGW AND NOT MINGW32CE)
      # 若满足条件，为当前目录添加编译选项，指定使用 Unicode 模式
      set_property(DIRECTORY APPEND PROPERTY COMPILE_OPTIONS "-municode")
    endif()
  endif()

  # 为所有特性检查添加编译定义，减少 Windows 头文件的包含内容
  list(APPEND CMAKE_REQUIRED_DEFINITIONS "-DWIN32_LEAN_AND_MEAN")
  # 检查是否使用 MSVC 编译器
  if(MSVC)
    # 若使用 MSVC 编译器，为所有特性检查添加编译定义，避免 strdup() 被标记为过时
    list(APPEND CMAKE_REQUIRED_DEFINITIONS "-D_CRT_NONSTDC_NO_DEPRECATE")  # for strdup() detection
  endif()

  # 定义一个缓存变量，用于指定目标 Windows 版本的最小版本号，以十六进制字符串表示
  set(CURL_TARGET_WINDOWS_VERSION "" CACHE STRING "Minimum target Windows version as hex string")
  # 若指定了目标 Windows 版本
  if(CURL_TARGET_WINDOWS_VERSION)
    # 为当前目录添加编译定义，指定目标 Windows 版本
    set_property(DIRECTORY APPEND PROPERTY COMPILE_DEFINITIONS "_WIN32_WINNT=${CURL_TARGET_WINDOWS_VERSION}")
    # 为所有特性检查添加编译定义，指定目标 Windows 版本
    list(APPEND CMAKE_REQUIRED_DEFINITIONS "-D_WIN32_WINNT=${CURL_TARGET_WINDOWS_VERSION}")  # Apply to all feature checks
  endif()

  # 调用自定义测试函数，检测实际的 _WIN32_WINNT 值，并存储在 HAVE_WIN32_WINNT 中
  curl_internal_test(HAVE_WIN32_WINNT)
  # 若检测到 _WIN32_WINNT 值
  if(HAVE_WIN32_WINNT)
    # 从测试输出中提取 _WIN32_WINNT 的值
    string(REGEX MATCH "_WIN32_WINNT=0x[0-9a-fA-F]+" CURL_TEST_OUTPUT "${CURL_TEST_OUTPUT}")
    # 去除 _WIN32_WINNT= 前缀
    string(REGEX REPLACE "_WIN32_WINNT=" "" CURL_TEST_OUTPUT "${CURL_TEST_OUTPUT}")
    # 将版本号补齐到 4 位十六进制数
    string(REGEX REPLACE "0x([0-9a-f][0-9a-f][0-9a-f])$" "0x0\\1" CURL_TEST_OUTPUT "${CURL_TEST_OUTPUT}")  # pad to 4 digits
    # 将版本号转换为小写
    string(TOLOWER "${CURL_TEST_OUTPUT}" HAVE_WIN32_WINNT)
    # 输出检测到的 _WIN32_WINNT 值
    message(STATUS "Found _WIN32_WINNT=${HAVE_WIN32_WINNT}")
  endif()
  # 避免将 HAVE_WIN32_WINNT 存储在 CMake 缓存中
  unset(HAVE_WIN32_WINNT CACHE)

  # 检查是否使用 MinGW 编译器
  if(MINGW)
    # 调用自定义测试函数，检测 MinGW64 的版本号，并存储在 MINGW64_VERSION 中
    curl_internal_test(MINGW64_VERSION)
    # 若检测到 MinGW64 版本号
    if(MINGW64_VERSION)
      # 从测试输出中提取 MINGW64_VERSION 的值
      string(REGEX MATCH "MINGW64_VERSION=[0-9]+\.[0-9]+" CURL_TEST_OUTPUT "${CURL_TEST_OUTPUT}")
      # 去除 MINGW64_VERSION= 前缀
      string(REGEX REPLACE "MINGW64_VERSION=" "" MINGW64_VERSION "${CURL_TEST_OUTPUT}")
      # 若成功提取到版本号
      if(MINGW64_VERSION)
        # 输出检测到的 MinGW64 版本号
        message(STATUS "Found MINGW64_VERSION=${MINGW64_VERSION}")
      endif()
    endif()
    # 避免将 MINGW64_VERSION 存储在 CMake 缓存中
    unset(MINGW64_VERSION CACHE)
  endif()
# 检查是否为 DOS 或 Amiga 平台
elseif(DOS OR AMIGA)
  # 若为 DOS 或 Amiga 平台，禁用共享库构建
  set(BUILD_SHARED_LIBS OFF)
  # 若为 DOS 或 Amiga 平台，启用静态库构建
  set(BUILD_STATIC_LIBS ON)
endif()

# 定义一个 CMake 选项，用于控制是否启用编译器链接时优化，默认关闭
option(CURL_LTO "Enable compiler Link Time Optimizations" OFF)

# 检查当前平台是否既不是 DOS 也不是 Amiga
if(NOT DOS AND NOT AMIGA)
  # 若使用 c-ares 库，将线程化 DNS 解析器的默认选项设置为关闭
  if(ENABLE_ARES)
    set(_enable_threaded_resolver_default OFF)
  else()
    # 若不使用 c-ares 库，将线程化 DNS 解析器的默认选项设置为打开
    set(_enable_threaded_resolver_default ON)
  endif()
  # 定义一个 CMake 选项，用于控制是否启用线程化 DNS 查找，默认值根据是否使用 c-ares 库而定
  option(ENABLE_THREADED_RESOLVER "Enable threaded DNS lookup" ${_enable_threaded_resolver_default})
endif()

# 包含 PickyWarnings 模块
include(PickyWarnings)

# 检查当前系统是否为 Linux
if(CMAKE_SYSTEM_NAME STREQUAL "Linux")
  # 若为 Linux 系统，为 C 编译器添加编译定义，以支持 sendmmsg() 函数
  string(APPEND CMAKE_C_FLAGS " -D_GNU_SOURCE")  # Required for sendmmsg()
endif()

# 定义一个 CMake 选项，用于控制是否启用 curl 的调试特性，默认关闭
option(ENABLE_DEBUG "Enable curl debug features (for developing curl itself)" OFF)
# 若启用了调试特性
if(ENABLE_DEBUG)
  # 输出警告信息，提示该构建版本为调试版本，不适合在生产环境中使用
  message(WARNING "This curl build is Debug-enabled and insecure, do not use in production.")
endif()
# 定义一个 CMake 选项，用于控制是否启用 TrackMemory 调试特性，默认值与 ENABLE_DEBUG 相同
option(ENABLE_CURLDEBUG "Enable TrackMemory debug feature" ${ENABLE_DEBUG})
# 定义一个 CMake 选项，用于控制是否将 curl 调试选项应用到测试服务器，默认关闭
option(ENABLE_SERVER_DEBUG "Apply curl debug options to test servers" OFF)

# 定义一个变量，用于存储 curl 调试宏
set(CURL_DEBUG_MACROS "")
# 若启用了调试特性
if(ENABLE_DEBUG)
  # 将 DEBUGBUILD 宏添加到调试宏列表中
  list(APPEND CURL_DEBUG_MACROS "DEBUGBUILD")
endif()
# 若启用了 TrackMemory 调试特性
if(ENABLE_CURLDEBUG)
  # 将 CURLDEBUG 宏添加到调试宏列表中
  list(APPEND CURL_DEBUG_MACROS "CURLDEBUG")
endif()

# 定义一个 CMake 选项，用于控制是否将测试构建为单二进制文件包，默认关闭
option(CURL_TEST_BUNDLES "Build tests into single-binary bundles" OFF)

# 定义一个 CMake 选项，用于控制是否使用 clang-tidy 进行构建检查，默认关闭
option(CURL_CLANG_TIDY "Run the build through clang-tidy" OFF)
# 若启用了 clang-tidy 检查
if(CURL_CLANG_TIDY)
  # clang-tidy 不会检查 #include 的源文件，因此与统一构建和测试包不兼容，禁用统一构建
  set(CMAKE_UNITY_BUILD OFF)
  # 禁用测试包构建
  set(CURL_TEST_BUNDLES OFF)
  # 定义一个变量，用于存储 clang-tidy 的检查选项
  set(_tidy_checks "")
  # 添加检查选项，禁用特定的安全检查
  list(APPEND _tidy_checks "-clang-analyzer-security.insecureAPI.strcpy")
  # 添加检查选项，禁用特定的性能检查
  list(APPEND _tidy_checks "-clang-analyzer-optin.performance.Padding")
  # 添加检查选项，禁用特定的不安全缓冲区处理检查
  list(APPEND _tidy_checks "-clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling")
  # 将检查选项列表转换为逗号分隔的字符串
  string(REPLACE ";" "," _tidy_checks "${_tidy_checks}")
  # 查找 clang-tidy 可执行文件，若未找到则报错
  find_program(CLANG_TIDY NAMES "clang-tidy" REQUIRED)
  # 设置 C 语言的 clang-tidy 检查命令
  set(CMAKE_C_CLANG_TIDY "${CLANG_TIDY}" "-checks=${_tidy_checks}" "-quiet")
  # 清除临时变量
  unset(_tidy_checks)
  # 若启用了将编译器警告视为错误的选项
  if(CURL_WERROR)
    # 将警告视为错误添加到 clang-tidy 检查命令中
    list(APPEND CMAKE_C_CLANG_TIDY "--warnings-as-errors=*")
  endif()
  # 若定义了自定义的 clang-tidy 检查标志
  if(CURL_CLANG_TIDYFLAGS)
    # 将自定义标志添加到 clang-tidy 检查命令中
    list(APPEND CMAKE_C_CLANG_TIDY ${CURL_CLANG_TIDYFLAGS})
  endif()
endif()

# 若未定义调试库和可执行文件的后缀
if(NOT DEFINED CMAKE_DEBUG_POSTFIX)
  # 设置调试库和可执行文件的后缀为 -d
  set(CMAKE_DEBUG_POSTFIX "-d")
endif()

# 定义静态库的名称
set(LIB_STATIC "libcurl_static")
# 定义共享库的名称
set(LIB_SHARED "libcurl_shared")

# 若既不构建共享库也不构建静态库
if(NOT BUILD_SHARED_LIBS AND NOT BUILD_STATIC_LIBS)
  # 强制启用静态库构建
  set(BUILD_STATIC_LIBS ON)
endif()
# 若不构建静态链接的 curl 可执行文件且不构建共享库
if(NOT BUILD_STATIC_CURL AND NOT BUILD_SHARED_LIBS)
  # 强制启用静态链接的 curl 可执行文件构建
  set(BUILD_STATIC_CURL ON)
# 若构建静态链接的 curl 可执行文件但不构建静态库
elseif(BUILD_STATIC_CURL AND NOT BUILD_STATIC_LIBS)
  # 禁用静态链接的 curl 可执行文件构建
  set(BUILD_STATIC_CURL OFF)
endif()

# 为 curl 工具选择要使用的库
if(BUILD_STATIC_CURL)
  # 若构建静态链接的 curl 可执行文件，选择静态库
  set(LIB_SELECTED_FOR_EXE ${LIB_STATIC})
else()
  # 否则选择共享库
  set(LIB_SELECTED_FOR_EXE ${LIB_SHARED})
endif()

# 为示例和测试程序选择要使用的库
if(BUILD_SHARED_LIBS)
  # 若构建共享库，选择共享库
  set(LIB_SELECTED ${LIB_SHARED})
else()
  # 否则选择静态库
  set(LIB_SELECTED ${LIB_STATIC})
endif()

# 检查当前是否为 Windows 平台
if(WIN32)
  # 定义一个 CMake 选项，用于控制是否使用静态 CRT 库构建 libcurl，默认关闭
  option(CURL_STATIC_CRT "Build libcurl with static CRT with MSVC (/MT)" OFF)
  # 若启用了使用静态 CRT 库构建且使用 MSVC 编译器
  if(CURL_STATIC_CRT AND MSVC)
    # 检查 MSVC 版本是否大于等于 1900，或者是否构建静态链接的 curl 可执行文件，或者是否不构建 curl 可执行文件
    if(MSVC_VERSION GREATER_EQUAL 1900 OR BUILD_STATIC_CURL OR NOT BUILD_CURL_EXE)
      # 设置 MSVC 运行时库为静态链接
      set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
      # 为发布版本的 C 编译器添加编译选项，使用静态链接的 CRT 库
      string(APPEND CMAKE_C_FLAGS_RELEASE " -MT")
      # 为调试版本的 C 编译器添加编译选项，使用静态链接的调试 CRT 库
      string(APPEND CMAKE_C_FLAGS_DEBUG " -MTd")
    else()
      # 若不满足条件，输出警告信息
      message(WARNING "Static CRT requires UCRT, static libcurl or no curl executable.")
    endif()
  endif()
endif()
# Override to force-disable or force-enable the use of pkg-config.
# 根据不同平台和工具链设置是否默认启用 pkg-config 来检测依赖项
if((UNIX AND NOT ANDROID AND (NOT APPLE OR CMAKE_SYSTEM_NAME MATCHES "Darwin")) OR
   VCPKG_TOOLCHAIN OR
   (MINGW AND NOT CMAKE_CROSSCOMPILING))
  # 在满足上述条件的平台或工具链下，默认启用 pkg-config
  set(_curl_use_pkgconfig_default ON)
else()
  # 其他情况下，默认禁用 pkg-config
  set(_curl_use_pkgconfig_default OFF)
endif()
# 定义一个 CMake 选项，用于控制是否启用 pkg-config 来检测依赖项，默认值由上面的逻辑决定
option(CURL_USE_PKGCONFIG "Enable pkg-config to detect dependencies" ${_curl_use_pkgconfig_default})

# Initialize variables collecting dependency libs, paths, pkg-config names.
# 初始化变量，用于收集依赖库、库路径和 pkg-config 依赖项名称
set(CURL_LIBS "")
set(CURL_LIBDIRS "")
set(LIBCURL_PC_REQUIRES_PRIVATE "")

# 检查是否启用 c-ares 支持
if(ENABLE_ARES)
  # 若启用 c-ares 支持，设置 USE_ARES 为 1
  set(USE_ARES 1)
  # 查找 Cares 库，若未找到则报错
  find_package(Cares REQUIRED)
  # 将 Cares 库添加到 CURL_LIBS 列表中
  list(APPEND CURL_LIBS ${CARES_LIBRARIES})
  # 将 Cares 库的路径添加到 CURL_LIBDIRS 列表中
  list(APPEND CURL_LIBDIRS ${CARES_LIBRARY_DIRS})
  # 将 Cares 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${CARES_PC_REQUIRES})
  # 设置链接目录为 Cares 库的路径
  link_directories(${CARES_LIBRARY_DIRS})
  # 若 Cares 库有编译标志，将其添加到 C 编译器标志中
  if(CARES_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${CARES_CFLAGS}")
  endif()
endif()

# 包含自定义的符号隐藏模块
include(CurlSymbolHiding)

# 定义一个 CMake 选项，用于控制是否启用 CMake 导出目标，默认启用
option(CURL_ENABLE_EXPORT_TARGET "Enable CMake export target" ON)
# 将该选项标记为高级选项
mark_as_advanced(CURL_ENABLE_EXPORT_TARGET)

# 定义一系列 CMake 选项，用于控制是否禁用 curl 的各种功能，默认均为禁用
# 并将这些选项标记为高级选项
option(CURL_DISABLE_ALTSVC "Disable alt-svc support" OFF)
mark_as_advanced(CURL_DISABLE_ALTSVC)
option(CURL_DISABLE_SRP "Disable TLS-SRP support" OFF)
mark_as_advanced(CURL_DISABLE_SRP)
option(CURL_DISABLE_COOKIES "Disable cookies support" OFF)
mark_as_advanced(CURL_DISABLE_COOKIES)
option(CURL_DISABLE_BASIC_AUTH "Disable Basic authentication" OFF)
mark_as_advanced(CURL_DISABLE_BASIC_AUTH)
option(CURL_DISABLE_BEARER_AUTH "Disable Bearer authentication" OFF)
mark_as_advanced(CURL_DISABLE_BEARER_AUTH)
option(CURL_DISABLE_DIGEST_AUTH "Disable Digest authentication" OFF)
mark_as_advanced(CURL_DISABLE_DIGEST_AUTH)
option(CURL_DISABLE_KERBEROS_AUTH "Disable Kerberos authentication" OFF)
mark_as_advanced(CURL_DISABLE_KERBEROS_AUTH)
option(CURL_DISABLE_NEGOTIATE_AUTH "Disable negotiate authentication" OFF)
mark_as_advanced(CURL_DISABLE_NEGOTIATE_AUTH)
option(CURL_DISABLE_AWS "Disable aws-sigv4" OFF)
mark_as_advanced(CURL_DISABLE_AWS)
option(CURL_DISABLE_DICT "Disable DICT" OFF)
mark_as_advanced(CURL_DISABLE_DICT)
option(CURL_DISABLE_DOH "Disable DNS-over-HTTPS" OFF)
mark_as_advanced(CURL_DISABLE_DOH)
option(CURL_DISABLE_FILE "Disable FILE" OFF)
mark_as_advanced(CURL_DISABLE_FILE)
option(CURL_DISABLE_FTP "Disable FTP" OFF)
mark_as_advanced(CURL_DISABLE_FTP)
option(CURL_DISABLE_GETOPTIONS "Disable curl_easy_options API for existing options to curl_easy_setopt" OFF)
mark_as_advanced(CURL_DISABLE_GETOPTIONS)
option(CURL_DISABLE_GOPHER "Disable Gopher" OFF)
mark_as_advanced(CURL_DISABLE_GOPHER)
option(CURL_DISABLE_HEADERS_API "Disable headers-api support" OFF)
mark_as_advanced(CURL_DISABLE_HEADERS_API)
option(CURL_DISABLE_HSTS "Disable HSTS support" OFF)
mark_as_advanced(CURL_DISABLE_HSTS)
option(CURL_DISABLE_HTTP "Disable HTTP" OFF)
mark_as_advanced(CURL_DISABLE_HTTP)
option(CURL_DISABLE_HTTP_AUTH "Disable all HTTP authentication methods" OFF)
mark_as_advanced(CURL_DISABLE_HTTP_AUTH)
option(CURL_DISABLE_IMAP "Disable IMAP" OFF)
mark_as_advanced(CURL_DISABLE_IMAP)
option(CURL_DISABLE_LDAP "Disable LDAP" OFF)
mark_as_advanced(CURL_DISABLE_LDAP)
option(CURL_DISABLE_LDAPS "Disable LDAPS" ${CURL_DISABLE_LDAP})
mark_as_advanced(CURL_DISABLE_LDAPS)
option(CURL_DISABLE_LIBCURL_OPTION "Disable --libcurl option from the curl tool" OFF)
mark_as_advanced(CURL_DISABLE_LIBCURL_OPTION)
option(CURL_DISABLE_MIME "Disable MIME support" OFF)
mark_as_advanced(CURL_DISABLE_MIME)
# 定义一个依赖选项，当 CURL_DISABLE_MIME 未启用时，默认禁用 form-api，否则启用
cmake_dependent_option(CURL_DISABLE_FORM_API "Disable form-api"
  OFF "NOT CURL_DISABLE_MIME"
  ON)
mark_as_advanced(CURL_DISABLE_FORM_API)
option(CURL_DISABLE_MQTT "Disable MQTT" OFF)
mark_as_advanced(CURL_DISABLE_MQTT)
option(CURL_DISABLE_BINDLOCAL "Disable local binding support" OFF)
mark_as_advanced(CURL_DISABLE_BINDLOCAL)
option(CURL_DISABLE_NETRC "Disable netrc parser" OFF)
mark_as_advanced(CURL_DISABLE_NETRC)
option(CURL_DISABLE_NTLM "Disable NTLM support" OFF)
mark_as_advanced(CURL_DISABLE_NTLM)
option(CURL_DISABLE_PARSEDATE "Disable date parsing" OFF)
mark_as_advanced(CURL_DISABLE_PARSEDATE)
option(CURL_DISABLE_POP3 "Disable POP3" OFF)
mark_as_advanced(CURL_DISABLE_POP3)
option(CURL_DISABLE_PROGRESS_METER "Disable built-in progress meter" OFF)
mark_as_advanced(CURL_DISABLE_PROGRESS_METER)
option(CURL_DISABLE_PROXY "Disable proxy support" OFF)
mark_as_advanced(CURL_DISABLE_PROXY)
option(CURL_DISABLE_IPFS "Disable IPFS" OFF)
mark_as_advanced(CURL_DISABLE_IPFS)
option(CURL_DISABLE_RTSP "Disable RTSP" OFF)
mark_as_advanced(CURL_DISABLE_RTSP)
option(CURL_DISABLE_SHA512_256 "Disable SHA-512/256 hash algorithm" OFF)
mark_as_advanced(CURL_DISABLE_SHA512_256)
option(CURL_DISABLE_SHUFFLE_DNS "Disable shuffle DNS feature" OFF)
mark_as_advanced(CURL_DISABLE_SHUFFLE_DNS)
option(CURL_DISABLE_SMB "Disable SMB" OFF)
mark_as_advanced(CURL_DISABLE_SMB)
option(CURL_DISABLE_SMTP "Disable SMTP" OFF)
mark_as_advanced(CURL_DISABLE_SMTP)
option(CURL_DISABLE_SOCKETPAIR "Disable use of socketpair for curl_multi_poll" OFF)
mark_as_advanced(CURL_DISABLE_SOCKETPAIR)
option(CURL_DISABLE_WEBSOCKETS "Disable WebSocket" OFF)
mark_as_advanced(CURL_DISABLE_WEBSOCKETS)
option(CURL_DISABLE_TELNET "Disable Telnet" OFF)
mark_as_advanced(CURL_DISABLE_TELNET)
option(CURL_DISABLE_TFTP "Disable TFTP" OFF)
mark_as_advanced(CURL_DISABLE_TFTP)
option(CURL_DISABLE_VERBOSE_STRINGS "Disable verbose strings" OFF)
mark_as_advanced(CURL_DISABLE_VERBOSE_STRINGS)

# 若禁用 HTTP 支持，则同时禁用 IPFS、RTSP、alt-svc 和 HSTS 支持
if(CURL_DISABLE_HTTP)
  set(CURL_DISABLE_IPFS ON)
  set(CURL_DISABLE_RTSP ON)
  set(CURL_DISABLE_ALTSVC ON)
  set(CURL_DISABLE_HSTS ON)
endif()

# 定义一个 CMake 选项，用于控制是否仅启用 HTTP 协议，禁用其他所有协议，默认禁用
# 该选项会覆盖所有 CURL_DISABLE_* 选项
option(HTTP_ONLY "Disable all protocols except HTTP (This overrides all CURL_DISABLE_* options)" OFF)
mark_as_advanced(HTTP_ONLY)

# 若仅启用 HTTP 协议，则禁用其他所有协议相关功能
if(HTTP_ONLY)
  set(CURL_DISABLE_DICT ON)
  set(CURL_DISABLE_FILE ON)
  set(CURL_DISABLE_FTP ON)
  set(CURL_DISABLE_GOPHER ON)
  set(CURL_DISABLE_IMAP ON)
  set(CURL_DISABLE_LDAP ON)
  set(CURL_DISABLE_LDAPS ON)
  set(CURL_DISABLE_MQTT ON)
  set(CURL_DISABLE_POP3 ON)
  set(CURL_DISABLE_IPFS ON)
  set(CURL_DISABLE_RTSP ON)
  set(CURL_DISABLE_SMB ON)
  set(CURL_DISABLE_SMTP ON)
  set(CURL_DISABLE_TELNET ON)
  set(CURL_DISABLE_TFTP ON)
endif()

# 若为 Windows Store 应用或 Windows CE 平台，禁用 Telnet 支持，因为 Telnet 代码在 UWP 下需要修复
if(WINDOWS_STORE OR WINCE)
  set(CURL_DISABLE_TELNET ON)
endif()

# 查找 Perl 解释器
find_package(Perl)

# 若找到 Perl 解释器
if(PERL_EXECUTABLE)
  # 添加自定义目标，用于生成新鲜的 ca-bundle.crt 文件
  add_custom_target(curl-ca-bundle
    COMMENT "Generating a fresh ca-bundle.crt" VERBATIM USES_TERMINAL
    COMMAND "${PERL_EXECUTABLE}" "${PROJECT_SOURCE_DIR}/scripts/mk-ca-bundle.pl" -b -l -u "lib/ca-bundle.crt"
    DEPENDS "${PROJECT_SOURCE_DIR}/scripts/mk-ca-bundle.pl"
  )
  # 添加自定义目标，用于从 Firefox 数据库生成 ca-bundle.crt 文件
  add_custom_target(curl-ca-firefox
    COMMENT "generating a fresh ca-bundle.crt" VERBATIM USES_TERMINAL
    COMMAND "${PERL_EXECUTABLE}" "${PROJECT_SOURCE_DIR}/scripts/firefox-db2pem.sh" "lib/ca-bundle.crt"
    DEPENDS "${PROJECT_SOURCE_DIR}/scripts/firefox-db2pem.sh"
  )
endif()

# 定义一个 CMake 选项，用于控制是否构建 libcurl 的手册页，默认启用
option(BUILD_LIBCURL_DOCS "Build libcurl man pages" ON)
# 定义一个 CMake 选项，用于控制是否构建其他手册页（如 curl-config 和 mk-ca-bundle），默认启用
option(BUILD_MISC_DOCS "Build misc man pages (e.g. curl-config and mk-ca-bundle)" ON)
# 定义一个 CMake 选项，用于控制是否构建 curl 的手册页并启用其 -M/--manual 选项，默认启用
option(ENABLE_CURL_MANUAL "Build the man page for curl and enable its -M/--manual option" ON)

# 若需要构建 curl 手册页或 libcurl 手册页
if(ENABLE_CURL_MANUAL OR BUILD_LIBCURL_DOCS)
  # 若找到 Perl 解释器，设置 HAVE_MANUAL_TOOLS 为 ON
  if(PERL_FOUND)
    set(HAVE_MANUAL_TOOLS ON)
  endif()
  # 若未找到 Perl 解释器，输出警告信息，提示不会构建手册页
  if(NOT HAVE_MANUAL_TOOLS)
    message(WARNING "Perl not found. Will not build manuals.")
  endif()
endif()

# 若当前系统为 AIX 系统，为编译添加 _ALL_SOURCE 定义
if(CMAKE_SYSTEM_NAME STREQUAL "AIX")
  set_property(DIRECTORY APPEND PROPERTY COMPILE_DEFINITIONS "_ALL_SOURCE")
endif()

# 若当前系统为 Haiku 系统，将 network 库添加到 CURL_LIBS 列表中
if(CMAKE_SYSTEM_NAME STREQUAL "Haiku")
  list(APPEND CURL_LIBS "network")
# 若当前系统为 Amiga 系统，将 net、m 和 atomic 库添加到 CURL_LIBS 和 CMAKE_REQUIRED_LIBRARIES 列表中
elseif(AMIGA)
  list(APPEND CURL_LIBS "net" "m" "atomic")
  list(APPEND CMAKE_REQUIRED_LIBRARIES "net" "m" "atomic")
endif()

# 包含所有必要的 CMake 模块，用于宏定义和功能检查
include(CMakePushCheckState)
include(CheckFunctionExists)
include(CheckIncludeFile)
include(CheckIncludeFiles)
include(CheckLibraryExists)
include(CheckSymbolExists)
include(CheckTypeSize)
include(CheckCSourceCompiles)

# 定义一个 CMake 选项，用于快速填充已知的特性检测结果，默认在 Windows 平台启用
option(_CURL_PREFILL "Fast-track known feature detection results (Windows, some Apple)" "${WIN32}")
# 检查是否启用快速填充特性检测结果
if(_CURL_PREFILL)
  # 若当前为 Windows 平台
  if(WIN32)
    # 包含 Windows 平台的缓存配置文件
    include("${CMAKE_CURRENT_SOURCE_DIR}/CMake/win32-cache.cmake")
  # 若当前为 Unix 平台
  elseif(UNIX)
    # 包含 Unix 平台的缓存配置文件
    include("${CMAKE_CURRENT_SOURCE_DIR}/CMake/unix-cache.cmake")
    # 输出信息提示正在为 Unix 平台预填充特性检测结果
    message(STATUS "Pre-filling feature detection results for UNIX")
  endif()
# 若未启用快速填充且当前为 Windows 平台
elseif(WIN32)
  # 输出信息提示预填充特性检测结果已禁用
  message(STATUS "Pre-filling feature detection results disabled.")
# 若当前为 Apple 平台
elseif(APPLE)
  # 设置相关特性检测结果
  set(HAVE_EVENTFD 0)
  set(HAVE_GETPASS_R 0)
  set(HAVE_WRITABLE_ARGV 1)
  set(HAVE_SENDMMSG 0)
endif()

# 若当前为 Amiga 平台
if(AMIGA)
  # 设置 Amiga 平台下 getaddrinfo 函数不可用，避免构建出错
  set(HAVE_GETADDRINFO 0)  # Breaks the build when detected and used.
endif()
# 若当前为 DOS 或 Amiga 平台
if(DOS OR AMIGA)
  # 设置 time_t 类型为无符号类型
  set(HAVE_TIME_T_UNSIGNED 1)
endif()

# 检查是否启用线程化 DNS 查找
if(ENABLE_THREADED_RESOLVER)
  # 若当前为 Windows 平台
  if(WIN32)
    # 启用 Windows 平台的线程支持
    set(USE_THREADS_WIN32 ON)
  else()
    # 查找线程库，若未找到则报错
    find_package(Threads REQUIRED)
    # 设置是否使用 POSIX 线程
    set(USE_THREADS_POSIX ${CMAKE_USE_PTHREADS_INIT})
    # 设置是否包含 pthreads 头文件
    set(HAVE_PTHREAD_H ${CMAKE_USE_PTHREADS_INIT})
    # 将线程库添加到 CURL 依赖库列表中
    list(APPEND CURL_LIBS ${CMAKE_THREAD_LIBS_INIT})
  endif()
endif()

# 检查所有需要的库
if(WIN32)
  # 若当前为 Windows CE 平台
  if(WINCE)
    # 设置 Windows CE 平台的 Winsock 库名
    set(_win32_winsock "ws2")
  else()
    # 设置其他 Windows 平台的 Winsock 库名
    set(_win32_winsock "ws2_32")
  endif()
  # 设置 Windows 平台的 Crypt32 库名
  set(_win32_crypt32 "crypt32")

  # 若当前为 MinGW32CE 环境
  if(MINGW32CE)  # FIXME upstream: must specify the full path to avoid CMake converting "ws2" to "ws2.lib"
    # 指定 Winsock 库的完整路径
    set(_win32_winsock "${MINGW32CE_LIBRARY_DIR}/lib${_win32_winsock}.a")
    # 指定 Crypt32 库的完整路径
    set(_win32_crypt32 "${MINGW32CE_LIBRARY_DIR}/lib${_win32_crypt32}.a")
  endif()
# 若当前为 DOS 平台
elseif(DOS)
  # 检查是否设置了 WATT_ROOT 变量
  if(WATT_ROOT)
    # 启用 Watt-32 库支持
    set(USE_WATT32 ON)
    # FIXME upstream: must specify the full path to avoid CMake converting "watt" to "watt.lib"
    # 将 Watt-32 库添加到 CURL 依赖库列表中
    list(APPEND CURL_LIBS "${WATT_ROOT}/lib/libwatt.a")
    # 添加 Watt-32 库的头文件目录到包含路径
    include_directories(SYSTEM "${WATT_ROOT}/inc")
    # 将 Watt-32 库的头文件目录添加到特性检查的包含路径中
    list(APPEND CMAKE_REQUIRED_INCLUDES "${WATT_ROOT}/inc")
  else()
    # 若未设置 WATT_ROOT 变量，输出错误信息并终止构建
    message(FATAL_ERROR "Set WATT_ROOT variable to the root installation of Watt-32.")
  endif()
# 若当前为 Amiga 平台
elseif(AMIGA)
  # 检查是否设置了 AmiSSL 相关目录和库
  if(AMISSL_INCLUDE_DIR AND AMISSL_STUBS_LIBRARY AND AMISSL_AUTO_LIBRARY)
    # 启用 AmiSSL 支持
    set(USE_AMISSL ON)
    # 将 AmiSSL 头文件目录添加到特性检查的包含路径中
    list(APPEND CMAKE_REQUIRED_INCLUDES "${AMISSL_INCLUDE_DIR}")
    # 将 AmiSSL 相关库添加到特性检查的依赖库列表中
    list(APPEND CMAKE_REQUIRED_LIBRARIES "${AMISSL_STUBS_LIBRARY}" "${AMISSL_AUTO_LIBRARY}")
    # 设置 OpenSSL 相关目录和库
    set(OPENSSL_INCLUDE_DIR "${AMISSL_INCLUDE_DIR}")
    set(OPENSSL_SSL_LIBRARY "${AMISSL_STUBS_LIBRARY}")
    set(OPENSSL_CRYPTO_LIBRARY "${AMISSL_AUTO_LIBRARY}")
    # 启用 OpenSSL 支持
    set(CURL_USE_OPENSSL ON)
    # 启用使用 TLS 后端内置 CA 存储
    set(CURL_CA_FALLBACK ON CACHE BOOL "")
  endif()
# 若当前不是 Apple 平台
elseif(NOT APPLE)
  # 检查 socket 库中是否存在 connect 函数
  check_library_exists("socket" "connect" "" HAVE_LIBSOCKET)
  # 若存在 socket 库
  if(HAVE_LIBSOCKET)
    # 将 socket 库添加到 CURL 依赖库列表中
    set(CURL_LIBS "socket" ${CURL_LIBS})
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否启用 IPv6 支持，默认启用
option(ENABLE_IPV6 "Enable IPv6 support" ON)
# 将该选项标记为高级选项
mark_as_advanced(ENABLE_IPV6)
# 检查是否启用 IPv6 支持
if(ENABLE_IPV6)
  # 包含检查结构体成员是否存在的模块
  include(CheckStructHasMember)
  # 若当前为 Windows 平台
  if(WIN32)
    # 检查 sockaddr_in6 结构体中是否存在 sin6_scope_id 成员
    check_struct_has_member("struct sockaddr_in6" "sin6_scope_id" "winsock2.h;ws2tcpip.h" HAVE_SOCKADDR_IN6_SIN6_SCOPE_ID)
  else()
    # 检查 sockaddr_in6 结构体中是否存在 sin6_scope_id 成员
    check_struct_has_member("struct sockaddr_in6" "sin6_scope_id" "netinet/in.h" HAVE_SOCKADDR_IN6_SIN6_SCOPE_ID)
    # 检查 sockaddr_in6 结构体中是否存在 sin6_addr 成员
    check_struct_has_member("struct sockaddr_in6" "sin6_addr" "netinet/in.h" HAVE_SOCKADDR_IN6_SIN6_ADDR)
    # 若 sockaddr_in6 结构体中不存在 sin6_addr 成员
    if(NOT HAVE_SOCKADDR_IN6_SIN6_ADDR)
      # 若当前不是 DOS 或 Amiga 平台
      if(NOT DOS AND NOT AMIGA)
        # 输出警告信息提示结构体不可用，将禁用 IPv6 支持
        message(WARNING "struct sockaddr_in6 not available, disabling IPv6 support")
      endif()
      # 强制禁用 IPv6 支持
      set(ENABLE_IPV6 OFF CACHE BOOL "Enable IPv6 support" FORCE)  # Force the feature off as we use this name as guard macro
    endif()

    # 若当前为 Apple 平台且未启用 c-ares 支持
    if(APPLE AND NOT ENABLE_ARES)
      # 启用使用 Core Foundation 和 Core Services 框架
      set(_use_core_foundation_and_core_services ON)

      # 查找 SystemConfiguration 框架
      find_library(SYSTEMCONFIGURATION_FRAMEWORK NAMES "SystemConfiguration")
      # 将该查找结果标记为高级选项
      mark_as_advanced(SYSTEMCONFIGURATION_FRAMEWORK)
      # 若未找到 SystemConfiguration 框架，输出错误信息并终止构建
      if(NOT SYSTEMCONFIGURATION_FRAMEWORK)
        message(FATAL_ERROR "SystemConfiguration framework not found")
      endif()
      # 将 SystemConfiguration 框架添加到 CURL 依赖库列表中
      list(APPEND CURL_LIBS "-framework SystemConfiguration")
    endif()
  endif()
endif()
# 若启用 IPv6 支持且当前不是 Windows CE 平台
if(ENABLE_IPV6 AND NOT WINCE)
  # 启用 IPv6 功能
  set(USE_IPV6 ON)
endif()

# 检查 SSL 库
# 定义一个 CMake 选项，用于控制是否启用 SSL 支持，默认启用
option(CURL_ENABLE_SSL "Enable SSL support" ON)

# 若设置了默认 SSL 后端
if(CURL_DEFAULT_SSL_BACKEND)
  # 初始化默认 SSL 后端是否有效标志为 FALSE
  set(_valid_default_ssl_backend FALSE)
endif()

# 若当前为 Apple 平台
if(APPLE)
  # 定义一个依赖选项，当启用 SSL 支持时，默认禁用 Apple 原生 SSL/TLS (Secure Transport)
  cmake_dependent_option(CURL_USE_SECTRANSP "Enable Apple OS native SSL/TLS (Secure Transport)" OFF CURL_ENABLE_SSL OFF)
endif()
# 若当前为 Windows 平台
if(WIN32)
  # 定义一个依赖选项，当启用 SSL 支持时，默认禁用 Windows 原生 SSL/TLS (Schannel)
  cmake_dependent_option(CURL_USE_SCHANNEL "Enable Windows native SSL/TLS (Schannel)" OFF CURL_ENABLE_SSL OFF)
  # 定义一个 CMake 选项，用于控制是否在 Windows 平台启用 SSPI，默认与 CURL_USE_SCHANNEL 选项相同
  option(CURL_WINDOWS_SSPI "Enable SSPI on Windows" ${CURL_USE_SCHANNEL})
endif()
# 定义一系列依赖选项，当启用 SSL 支持时，默认禁用相应的 SSL/TLS 库
cmake_dependent_option(CURL_USE_MBEDTLS "Enable mbedTLS for SSL/TLS" OFF CURL_ENABLE_SSL OFF)
cmake_dependent_option(CURL_USE_BEARSSL "Enable BearSSL for SSL/TLS" OFF CURL_ENABLE_SSL OFF)
cmake_dependent_option(CURL_USE_WOLFSSL "Enable wolfSSL for SSL/TLS" OFF CURL_ENABLE_SSL OFF)
cmake_dependent_option(CURL_USE_GNUTLS "Enable GnuTLS for SSL/TLS" OFF CURL_ENABLE_SSL OFF)
cmake_dependent_option(CURL_USE_RUSTLS "Enable Rustls for SSL/TLS" OFF CURL_ENABLE_SSL OFF)

# 根据不同平台和 SSL 库选项设置 OpenSSL 默认启用状态
if(WIN32 OR
   CURL_USE_SECTRANSP OR
   CURL_USE_SCHANNEL OR
   CURL_USE_MBEDTLS OR
   CURL_USE_BEARSSL OR
   CURL_USE_WOLFSSL OR
   CURL_USE_GNUTLS OR
   CURL_USE_RUSTLS)
  set(_openssl_default OFF)
else()
  set(_openssl_default ON)
endif()
# 定义一个依赖选项，当启用 SSL 支持时，根据 _openssl_default 设置是否启用 OpenSSL
cmake_dependent_option(CURL_USE_OPENSSL "Enable OpenSSL for SSL/TLS" ${_openssl_default} CURL_ENABLE_SSL OFF)
# 定义一个 CMake 选项，用于控制是否使用 OpenSSL 和 nghttp3 库实现 HTTP/3 支持，默认禁用
option(USE_OPENSSL_QUIC "Use OpenSSL and nghttp3 libraries for HTTP/3 support" OFF)
# 若启用 OpenSSL QUIC 但未启用 OpenSSL，输出警告信息并禁用 OpenSSL QUIC
if(USE_OPENSSL_QUIC AND NOT CURL_USE_OPENSSL)
  message(WARNING "OpenSSL QUIC has been requested, but without enabling OpenSSL. Will not enable QUIC.")
  set(USE_OPENSSL_QUIC OFF)
endif()
# 定义一个 CMake 选项，用于控制是否禁用 OpenSSL 配置的自动加载，默认禁用
option(CURL_DISABLE_OPENSSL_AUTO_LOAD_CONFIG "Disable automatic loading of OpenSSL configuration" OFF)

# 统计启用的 SSL 选项数量
curl_count_true(_enabled_ssl_options_count
  CURL_USE_SCHANNEL
  CURL_USE_SECTRANSP
  CURL_USE_OPENSSL
  CURL_USE_MBEDTLS
  CURL_USE_BEARSSL
  CURL_USE_WOLFSSL
  CURL_USE_GNUTLS
  CURL_USE_RUSTLS
)
# 若启用的 SSL 选项数量大于 1
if(_enabled_ssl_options_count GREATER 1)
  # 启用多 SSL 支持
  set(CURL_WITH_MULTI_SSL ON)
# 若启用的 SSL 选项数量为 0
elseif(_enabled_ssl_options_count EQUAL 0)
  # 禁用 HSTS 支持
  set(CURL_DISABLE_HSTS ON)
endif()

# 若启用 Windows 原生 SSL/TLS (Schannel)
if(CURL_USE_SCHANNEL)
  # 启用 SSL 支持
  set(_ssl_enabled ON)
  # 启用 Windows 原生 SSL/TLS 支持
  set(USE_SCHANNEL ON)  # Windows native SSL/TLS support
  # 启用 Windows SSPI 支持，因为 CURL_USE_SCHANNEL 需要 CURL_WINDOWS_SSPI
  set(USE_WINDOWS_SSPI ON)  # CURL_USE_SCHANNEL requires CURL_WINDOWS_SSPI

  # 若设置了默认 SSL 后端且为 schannel，标记默认 SSL 后端有效
  if(CURL_DEFAULT_SSL_BACKEND AND CURL_DEFAULT_SSL_BACKEND STREQUAL "schannel")
    set(_valid_default_ssl_backend TRUE)
  endif()
endif()
# 若启用 Windows SSPI 支持
if(CURL_WINDOWS_SSPI)
  # 启用 Windows SSPI 支持
  set(USE_WINDOWS_SSPI ON)
endif()

# 若启用 Apple 原生 SSL/TLS (Secure Transport)
if(CURL_USE_SECTRANSP)
  # 启用使用 Core Foundation 和 Core Services 框架
  set(_use_core_foundation_and_core_services ON)

  # 查找 Security 框架
  find_library(SECURITY_FRAMEWORK NAMES "Security")
  # 将该查找结果标记为高级选项
  mark_as_advanced(SECURITY_FRAMEWORK)
  # 若未找到 Security 框架，输出错误信息并终止构建
  if(NOT SECURITY_FRAMEWORK)
    message(FATAL_ERROR "Security framework not found")
  endif()
  # 将 Security 框架添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS "-framework Security")

  # 启用 SSL 支持
  set(_ssl_enabled ON)
  # 启用 Apple 原生 SSL/TLS 支持
  set(USE_SECTRANSP ON)

  # 若设置了默认 SSL 后端且为 secure-transport，标记默认 SSL 后端有效
  if(CURL_DEFAULT_SSL_BACKEND AND CURL_DEFAULT_SSL_BACKEND STREQUAL "secure-transport")
    set(_valid_default_ssl_backend TRUE)
  endif()

  # 输出警告信息提示 Secure Transport 不支持 TLS 1.3
  message(WARNING "Secure Transport does not support TLS 1.3.")
endif()

# 若启用使用 Core Foundation 和 Core Services 框架
if(_use_core_foundation_and_core_services)
  # 查找 CoreFoundation 框架
  find_library(COREFOUNDATION_FRAMEWORK NAMES "CoreFoundation")
  # 将该查找结果标记为高级选项
  mark_as_advanced(COREFOUNDATION_FRAMEWORK)
  # 若未找到 CoreFoundation 框架，输出错误信息并终止构建
  if(NOT COREFOUNDATION_FRAMEWORK)
    message(FATAL_ERROR "CoreFoundation framework not found")
  endif()
  # 将 CoreFoundation 框架添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS "-framework CoreFoundation")

  # 查找 CoreServices 框架
  find_library(CORESERVICES_FRAMEWORK NAMES "CoreServices")
  # 将该查找结果标记为高级选项
  mark_as_advanced(CORESERVICES_FRAMEWORK)
  # 若未找到 CoreServices 框架，输出错误信息并终止构建
  if(NOT CORESERVICES_FRAMEWORK)
    message(FATAL_ERROR "CoreServices framework not found")
  endif()
  # 将 CoreServices 框架添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS "-framework CoreServices")
endif()

# 若启用 OpenSSL 支持
if(CURL_USE_OPENSSL)
  # 查找 OpenSSL 库，若未找到则报错
  find_package(OpenSSL REQUIRED)
  # 启用 SSL 支持
  set(_ssl_enabled ON)
  # 启用 OpenSSL 支持
  set(USE_OPENSSL ON)

  # 通过导入目标依赖 OpenSSL，以便依赖项可以传递获取依赖
  list(APPEND CURL_LIBS OpenSSL::SSL OpenSSL::Crypto)
  # 将 OpenSSL 添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE "openssl")

  # 若设置了默认 SSL 后端且为 openssl，标记默认 SSL 后端有效
  if(CURL_DEFAULT_SSL_BACKEND AND CURL_DEFAULT_SSL_BACKEND STREQUAL "openssl")
    set(_valid_default_ssl_backend TRUE)
  endif()
  # 标记支持使用 CA 证书捆绑文件
  set(_curl_ca_bundle_supported TRUE)

  # 保存当前检查状态
  cmake_push_check_state()
  # 将 OpenSSL 相关库添加到特性检查的依赖库列表中
  list(APPEND CMAKE_REQUIRED_LIBRARIES OpenSSL::SSL OpenSSL::Crypto)
  # 若未定义 HAVE_BORINGSSL，检查是否使用 BoringSSL
  if(NOT DEFINED HAVE_BORINGSSL)
    check_symbol_exists("OPENSSL_IS_BORINGSSL" "openssl/base.h" HAVE_BORINGSSL)
  endif()
  # 若未定义 HAVE_AWSLC，检查是否使用 AWS-LC
  if(NOT DEFINED HAVE_AWSLC)
    check_symbol_exists("OPENSSL_IS_AWSLC" "openssl/base.h" HAVE_AWSLC)
  endif()
  # 若未定义 HAVE_LIBRESSL，检查是否使用 LibreSSL
  if(NOT DEFINED HAVE_LIBRESSL)
    check_symbol_exists("LIBRESSL_VERSION_NUMBER" "openssl/opensslv.h" HAVE_LIBRESSL)
  endif()
  # 恢复之前保存的检查状态
  cmake_pop_check_state()

  # 若使用 BoringSSL 或 AWS-LC 且静态链接 OpenSSL 并使用 Clang 编译器
  if(HAVE_BORINGSSL OR HAVE_AWSLC)
    if(OPENSSL_USE_STATIC_LIBS AND CMAKE_C_COMPILER_ID MATCHES "Clang")
      # 将 stdc++ 库添加到 CURL 依赖库列表中
      list(APPEND CURL_LIBS "stdc++")
      # 将 stdc++ 库添加到特性检查的依赖库列表中
      list(APPEND CMAKE_REQUIRED_LIBRARIES "stdc++")
    endif()
  endif()

  # 根据不同的 OpenSSL 分支设置 _openssl 变量
  if(HAVE_BORINGSSL)
    set(_openssl "BoringSSL")
  elseif(HAVE_AWSLC)
    set(_openssl "AWS-LC")
  elseif(HAVE_LIBRESSL)
    set(_openssl "LibreSSL")
  elseif(USE_AMISSL)
    set(_openssl "AmiSSL")
  else()
    set(_openssl "OpenSSL")
  endif()
endif()

# 检查是否启用 mbedTLS 作为 SSL/TLS 库
if(CURL_USE_MBEDTLS)
  # 查找 mbedTLS 库，若未找到则报错
  find_package(MbedTLS REQUIRED)
  # 启用 SSL 支持
  set(_ssl_enabled ON)
  # 启用 mbedTLS 支持
  set(USE_MBEDTLS ON)
  # 将 mbedTLS 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${MBEDTLS_LIBRARIES})
  # 将 mbedTLS 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${MBEDTLS_LIBRARY_DIRS})
  # 将 mbedTLS 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${MBEDTLS_PC_REQUIRES})
  # 添加 mbedTLS 头文件目录到系统包含路径
  include_directories(SYSTEM ${MBEDTLS_INCLUDE_DIRS})
  # 设置链接目录为 mbedTLS 库的路径
  link_directories(${MBEDTLS_LIBRARY_DIRS})
  # 若 mbedTLS 库有编译标志，将其添加到 C 编译器标志中
  if(MBEDTLS_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${MBEDTLS_CFLAGS}")
  endif()

  # 若设置了默认 SSL 后端且为 mbedtls，标记默认 SSL 后端有效
  if(CURL_DEFAULT_SSL_BACKEND AND CURL_DEFAULT_SSL_BACKEND STREQUAL "mbedtls")
    set(_valid_default_ssl_backend TRUE)
  endif()
  # 标记支持使用 CA 证书捆绑文件
  set(_curl_ca_bundle_supported TRUE)
endif()

# 检查是否启用 BearSSL 作为 SSL/TLS 库
if(CURL_USE_BEARSSL)
  # 查找 BearSSL 库，若未找到则报错
  find_package(BearSSL REQUIRED)
  # 启用 SSL 支持
  set(_ssl_enabled ON)
  # 启用 BearSSL 支持
  set(USE_BEARSSL ON)
  # 将 BearSSL 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${BEARSSL_LIBRARIES})
  # 添加 BearSSL 头文件目录到系统包含路径
  include_directories(SYSTEM ${BEARSSL_INCLUDE_DIRS})

  # 若设置了默认 SSL 后端且为 bearssl，标记默认 SSL 后端有效
  if(CURL_DEFAULT_SSL_BACKEND AND CURL_DEFAULT_SSL_BACKEND STREQUAL "bearssl")
    set(_valid_default_ssl_backend TRUE)
  endif()
  # 标记支持使用 CA 证书捆绑文件
  set(_curl_ca_bundle_supported TRUE)

  # 输出警告信息提示 BearSSL 不支持 TLS 1.3
  message(WARNING "BearSSL does not support TLS 1.3.")
endif()

# 检查是否启用 wolfSSL 作为 SSL/TLS 库
if(CURL_USE_WOLFSSL)
  # 查找 wolfSSL 库，若未找到则报错
  find_package(WolfSSL REQUIRED)
  # 启用 SSL 支持
  set(_ssl_enabled ON)
  # 启用 wolfSSL 支持
  set(USE_WOLFSSL ON)
  # 将 wolfSSL 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${WOLFSSL_LIBRARIES})
  # 将 wolfSSL 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${WOLFSSL_LIBRARY_DIRS})
  # 将 wolfSSL 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${WOLFSSL_PC_REQUIRES})
  # 添加 wolfSSL 头文件目录到系统包含路径
  include_directories(SYSTEM ${WOLFSSL_INCLUDE_DIRS})
  # 设置链接目录为 wolfSSL 库的路径
  link_directories(${WOLFSSL_LIBRARY_DIRS})
  # 若 wolfSSL 库有编译标志，将其添加到 C 编译器标志中
  if(WOLFSSL_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${WOLFSSL_CFLAGS}")
  endif()

  # 若设置了默认 SSL 后端且为 wolfssl，标记默认 SSL 后端有效
  if(CURL_DEFAULT_SSL_BACKEND AND CURL_DEFAULT_SSL_BACKEND STREQUAL "wolfssl")
    set(_valid_default_ssl_backend TRUE)
  endif()
  # 标记支持使用 CA 证书捆绑文件
  set(_curl_ca_bundle_supported TRUE)
endif()

# 检查是否启用 GnuTLS 作为 SSL/TLS 库
if(CURL_USE_GNUTLS)
  # 若启用 pkg-config 来检测依赖项
  if(CURL_USE_PKGCONFIG)
    # 查找 PkgConfig 模块，静默模式
    find_package(PkgConfig QUIET)
    # 使用 pkg-config 检查 GnuTLS 库
    pkg_check_modules(GNUTLS "gnutls")
    # 若找到 GnuTLS 库
    if(GNUTLS_FOUND)
      # 设置 GnuTLS 库列表
      set(GNUTLS_LIBRARIES ${GNUTLS_LINK_LIBRARIES})
      # 将 GnuTLS 编译标志列表转换为空格分隔的字符串
      string(REPLACE ";" " " GNUTLS_CFLAGS "${GNUTLS_CFLAGS}")
      # 若 GnuTLS 库有编译标志，将其添加到 C 编译器标志中
      if(GNUTLS_CFLAGS)
        string(APPEND CMAKE_C_FLAGS " ${GNUTLS_CFLAGS}")
      endif()
    endif()
  endif()
  # 若未找到 GnuTLS 库
  if(NOT GNUTLS_FOUND)
    # 查找 GnuTLS 库，若未找到则报错
    find_package(GnuTLS REQUIRED)
  endif()
  # 查找 Nettle 库，若未找到则报错
  find_package(Nettle REQUIRED)
  # 启用 SSL 支持
  set(_ssl_enabled ON)
  # 启用 GnuTLS 支持
  set(USE_GNUTLS ON)
  # 将 GnuTLS 和 Nettle 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${GNUTLS_LIBRARIES} ${NETTLE_LIBRARIES})
  # 将 GnuTLS 和 Nettle 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${GNUTLS_LIBRARY_DIRS} ${NETTLE_LIBRARY_DIRS})
  # 将 GnuTLS 和 Nettle 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE "gnutls" ${NETTLE_PC_REQUIRES})
  # 添加 GnuTLS 和 Nettle 头文件目录到系统包含路径
  include_directories(SYSTEM ${GNUTLS_INCLUDE_DIRS} ${NETTLE_INCLUDE_DIRS})
  # 设置链接目录为 Nettle 库的路径
  link_directories(${NETTLE_LIBRARY_DIRS})
  # 若 Nettle 库有编译标志，将其添加到 C 编译器标志中
  if(NETTLE_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${NETTLE_CFLAGS}")
  endif()

  # 若设置了默认 SSL 后端且为 gnutls，标记默认 SSL 后端有效
  if(CURL_DEFAULT_SSL_BACKEND AND CURL_DEFAULT_SSL_BACKEND STREQUAL "gnutls")
    set(_valid_default_ssl_backend TRUE)
  endif()
  # 标记支持使用 CA 证书捆绑文件
  set(_curl_ca_bundle_supported TRUE)

  # 若未定义 HAVE_GNUTLS_SRP 且未禁用 SRP 支持
  if(NOT DEFINED HAVE_GNUTLS_SRP AND NOT CURL_DISABLE_SRP)
    # 保存当前检查状态
    cmake_push_check_state()
    # 将 GnuTLS 头文件目录添加到特性检查的包含路径中
    list(APPEND CMAKE_REQUIRED_INCLUDES ${GNUTLS_INCLUDE_DIRS})
    # 将 GnuTLS 库添加到特性检查的依赖库列表中
    list(APPEND CMAKE_REQUIRED_LIBRARIES ${GNUTLS_LIBRARIES})
    # 检查 gnutls_srp_verifier 符号是否存在
    check_symbol_exists("gnutls_srp_verifier" "gnutls/gnutls.h" HAVE_GNUTLS_SRP)
    # 恢复之前保存的检查状态
    cmake_pop_check_state()
  endif()
endif()

# 检查是否启用 Rustls 作为 SSL/TLS 库
if(CURL_USE_RUSTLS)
  # 查找 Rustls 库，若未找到则报错
  find_package(Rustls REQUIRED)
  # 启用 SSL 支持
  set(_ssl_enabled ON)
  # 启用 Rustls 支持
  set(USE_RUSTLS ON)
  # 将 Rustls 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${RUSTLS_LIBRARIES})
  # 将 Rustls 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${RUSTLS_LIBRARY_DIRS})
  # 将 Rustls 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${RUSTLS_PC_REQUIRES})
  # 添加 Rustls 头文件目录到系统包含路径
  include_directories(SYSTEM ${RUSTLS_INCLUDE_DIRS})
  # 设置链接目录为 Rustls 库的路径
  link_directories(${RUSTLS_LIBRARY_DIRS})
  # 若 Rustls 库有编译标志，将其添加到 C 编译器标志中
  if(RUSTLS_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${RUSTLS_CFLAGS}")
  endif()

  # 若设置了默认 SSL 后端且为 rustls，标记默认 SSL 后端有效
  if(CURL_DEFAULT_SSL_BACKEND AND CURL_DEFAULT_SSL_BACKEND STREQUAL "rustls")
    set(_valid_default_ssl_backend TRUE)
  endif()
  # 标记支持使用 CA 证书捆绑文件
  set(_curl_ca_bundle_supported TRUE)
endif()

# 若设置了默认 SSL 后端且默认 SSL 后端无效
if(CURL_DEFAULT_SSL_BACKEND AND NOT _valid_default_ssl_backend)
  # 输出错误信息并终止构建
  message(FATAL_ERROR "CURL_DEFAULT_SSL_BACKEND '${CURL_DEFAULT_SSL_BACKEND}' not enabled.")
endif()

# 将 ZLIB 检测放在 TLS 检测之后，
# 并在调用 curl_openssl_check_exists() 之前。

# 初始化 HAVE_LIBZ 变量为 OFF，表示未找到 ZLIB 库
set(HAVE_LIBZ OFF)
# 调用自定义函数检查 ZLIB 依赖
curl_dependency_option(CURL_ZLIB ZLIB "ZLIB")
# 若找到 ZLIB 库
if(ZLIB_FOUND)
  # 标记找到 ZLIB 库
  set(HAVE_LIBZ ON)
  # 通过导入目标依赖 ZLIB，以便依赖项可以传递获取依赖
  list(APPEND CURL_LIBS ZLIB::ZLIB)
  # 将 ZLIB 添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE "zlib")
endif()

# 初始化 HAVE_BROTLI 变量为 OFF，表示未找到 Brotli 库
set(HAVE_BROTLI OFF)
# 调用自定义函数检查 Brotli 依赖
curl_dependency_option(CURL_BROTLI Brotli "brotli")
# 若找到 Brotli 库
if(BROTLI_FOUND)
  # 标记找到 Brotli 库
  set(HAVE_BROTLI ON)
  # 将 Brotli 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${BROTLI_LIBRARIES})
  # 将 Brotli 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${BROTLI_LIBRARY_DIRS})
  # 将 Brotli 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${BROTLI_PC_REQUIRES})
  # 添加 Brotli 头文件目录到系统包含路径
  include_directories(SYSTEM ${BROTLI_INCLUDE_DIRS})
  # 设置链接目录为 Brotli 库的路径
  link_directories(${BROTLI_LIBRARY_DIRS})
  # 若 Brotli 库有编译标志，将其添加到 C 编译器标志中
  if(BROTLI_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${BROTLI_CFLAGS}")
  endif()
endif()

# 初始化 HAVE_ZSTD 变量为 OFF，表示未找到 Zstd 库
set(HAVE_ZSTD OFF)
# 调用自定义函数检查 Zstd 依赖
curl_dependency_option(CURL_ZSTD Zstd "zstd")
# 若找到 Zstd 库
if(ZSTD_FOUND)
  # 若 Zstd 版本不低于 1.0.0
  if(NOT ZSTD_VERSION VERSION_LESS 1.0.0)
    # 标记找到 Zstd 库
    set(HAVE_ZSTD ON)
    # 将 Zstd 库添加到 CURL 依赖库列表中
    list(APPEND CURL_LIBS ${ZSTD_LIBRARIES})
    # 将 Zstd 库的路径添加到 CURL 库路径列表中
    list(APPEND CURL_LIBDIRS ${ZSTD_LIBRARY_DIRS})
    # 将 Zstd 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
    list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${ZSTD_PC_REQUIRES})
    # 添加 Zstd 头文件目录到系统包含路径
    include_directories(SYSTEM ${ZSTD_INCLUDE_DIRS})
    # 设置链接目录为 Zstd 库的路径
    link_directories(${ZSTD_LIBRARY_DIRS})
    # 若 Zstd 库有编译标志，将其添加到 C 编译器标志中
    if(ZSTD_CFLAGS)
      string(APPEND CMAKE_C_FLAGS " ${ZSTD_CFLAGS}")
    endif()
  else()
    # 输出警告信息提示 zstd 版本过低，禁用 zstd 支持
    message(WARNING "zstd v1.0.0 or newer is required, disabling zstd support.")
  endif()
endif()
# Check function in an OpenSSL-like TLS backend.
# 检查类似 OpenSSL 的 TLS 后端中是否存在指定函数或符号
macro(curl_openssl_check_exists)
  # 保存当前的检查状态，以便后续恢复
  cmake_push_check_state()
  # 若启用了 OpenSSL 支持
  if(USE_OPENSSL)
    # 将 OpenSSL 的 SSL 和 Crypto 库添加到特性检查的依赖库列表中
    list(APPEND CMAKE_REQUIRED_LIBRARIES OpenSSL::SSL OpenSSL::Crypto)
    # 添加编译定义，抑制 OpenSSL 弃用警告（SSL_CTX_set_srp_username 自 3.0.0 版本起弃用）
    list(APPEND CMAKE_REQUIRED_DEFINITIONS "-DOPENSSL_SUPPRESS_DEPRECATED")
    # 若找到 ZLIB 库
    if(HAVE_LIBZ)
      # 将 ZLIB 库添加到特性检查的依赖库列表中
      list(APPEND CMAKE_REQUIRED_LIBRARIES ZLIB::ZLIB)
    endif()
    # 若当前为 Windows 平台且非 Windows CE
    if(WIN32 AND NOT WINCE)
      # 将 Windows 的 Winsock 库添加到特性检查的依赖库列表中
      list(APPEND CMAKE_REQUIRED_LIBRARIES "${_win32_winsock}")
      # 将 bcrypt 库添加到特性检查的依赖库列表中（用于 OpenSSL/LibreSSL）
      list(APPEND CMAKE_REQUIRED_LIBRARIES "bcrypt")
    endif()
  endif()
  # 若启用了 wolfSSL 支持
  if(USE_WOLFSSL)
    # 将 wolfSSL 的头文件目录添加到特性检查的包含路径中
    list(APPEND CMAKE_REQUIRED_INCLUDES   "${WOLFSSL_INCLUDE_DIRS}")
    # 将 wolfSSL 库添加到特性检查的依赖库列表中
    list(APPEND CMAKE_REQUIRED_LIBRARIES  "${WOLFSSL_LIBRARIES}")
    # 调用自定义函数设置 wolfSSL 库的路径
    curl_required_libpaths("${WOLFSSL_LIBRARY_DIRS}")
    # 若找到 ZLIB 库
    if(HAVE_LIBZ)
      # 将 ZLIB 库添加到特性检查的依赖库列表中（wolfSSL 公共头文件也需要 zlib 头文件）
      list(APPEND CMAKE_REQUIRED_LIBRARIES ZLIB::ZLIB)
    endif()
    # 若当前为 Windows 平台
    if(WIN32)
      # 将 Windows 的 Winsock 和 Crypt32 库添加到特性检查的依赖库列表中
      list(APPEND CMAKE_REQUIRED_LIBRARIES "${_win32_winsock}" "${_win32_crypt32}")
    endif()
    # 添加编译定义，引入 stdint.h 头文件（wolfSSL v5.5.4 及以后版本需要）
    list(APPEND CMAKE_REQUIRED_DEFINITIONS "-DHAVE_UINTPTR_T")
  endif()
  # 若宏的参数数量为 2
  if(${ARGC} EQUAL 2)
    # 检查指定函数是否存在
    check_function_exists(${ARGN})
  else()
    # 检查指定符号是否存在（使用 CMAKE_REQUIRED_INCLUDES 和 CMAKE_REQUIRED_DEFINITIONS）
    check_symbol_exists(${ARGN})
  endif()
  # 恢复之前保存的检查状态
  cmake_pop_check_state()
endmacro()

# Ensure that the OpenSSL fork actually supports QUIC.
# 确保 OpenSSL 分支实际支持 QUIC
macro(curl_openssl_check_quic)
  # 若未定义 HAVE_SSL_SET_QUIC_USE_LEGACY_CODEPOINT
  if(NOT DEFINED HAVE_SSL_SET_QUIC_USE_LEGACY_CODEPOINT)
    # 若启用了 OpenSSL 支持
    if(USE_OPENSSL)
      # 检查 OpenSSL 中是否存在 SSL_set_quic_use_legacy_codepoint 函数
      curl_openssl_check_exists("SSL_set_quic_use_legacy_codepoint" HAVE_SSL_SET_QUIC_USE_LEGACY_CODEPOINT)
    endif()
    # 若启用了 wolfSSL 支持
    if(USE_WOLFSSL)
      # 检查 wolfSSL 中是否存在 wolfSSL_set_quic_use_legacy_codepoint 函数
      curl_openssl_check_exists("wolfSSL_set_quic_use_legacy_codepoint" HAVE_SSL_SET_QUIC_USE_LEGACY_CODEPOINT)
    endif()
  endif()
  # 若不支持 SSL_set_quic_use_legacy_codepoint 函数
  if(NOT HAVE_SSL_SET_QUIC_USE_LEGACY_CODEPOINT)
    # 输出错误信息并终止构建，提示用户尝试设置 -DOPENSSL_ROOT_DIR
    message(FATAL_ERROR "QUIC support is missing in OpenSSL fork. Try setting -DOPENSSL_ROOT_DIR")
  endif()
endmacro()

# 若启用了 wolfSSL 支持
if(USE_WOLFSSL)
  # 检查 wolfSSL 中是否存在 wolfSSL_DES_ecb_encrypt 函数
  curl_openssl_check_exists("wolfSSL_DES_ecb_encrypt" HAVE_WOLFSSL_DES_ECB_ENCRYPT)
  # 检查 wolfSSL 中是否存在 wolfSSL_BIO_new 函数
  curl_openssl_check_exists("wolfSSL_BIO_new" HAVE_WOLFSSL_BIO)
  # 检查 wolfSSL 中是否存在 wolfSSL_BIO_set_shutdown 函数
  curl_openssl_check_exists("wolfSSL_BIO_set_shutdown" HAVE_WOLFSSL_FULL_BIO)
endif()

# 若启用了 OpenSSL 支持
if(USE_OPENSSL)
  # 若未定义 HAVE_SSL_SET0_WBIO
  if(NOT DEFINED HAVE_SSL_SET0_WBIO)
    # 检查 OpenSSL 中是否存在 SSL_set0_wbio 函数
    curl_openssl_check_exists("SSL_set0_wbio" HAVE_SSL_SET0_WBIO)
  endif()
  # 若未定义 HAVE_OPENSSL_SRP 且未禁用 SRP 支持
  if(NOT DEFINED HAVE_OPENSSL_SRP AND NOT CURL_DISABLE_SRP)
    # 检查 OpenSSL 中是否存在 SSL_CTX_set_srp_username 符号
    curl_openssl_check_exists("SSL_CTX_set_srp_username" "openssl/ssl.h" HAVE_OPENSSL_SRP)
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否启用 HTTPS RR 支持，默认禁用
option(USE_HTTPSRR "Enable HTTPS RR support" OFF)
# 定义一个 CMake 选项，用于控制是否启用 ECH 支持，默认禁用
option(USE_ECH "Enable ECH support" OFF)
# 若启用了 ECH 支持
if(USE_ECH)
  # 若启用了 OpenSSL、wolfSSL 或 Rustls 支持
  if(USE_OPENSSL OR USE_WOLFSSL OR USE_RUSTLS)
    # 确保 TLS 库实际支持 ECH
    # 若启用了 wolfSSL 支持
    if(USE_WOLFSSL)
      # 检查 wolfSSL 中是否存在 wolfSSL_CTX_GenerateEchConfig 函数
      curl_openssl_check_exists("wolfSSL_CTX_GenerateEchConfig" HAVE_WOLFSSL_CTX_GENERATEECHCONFIG)
    endif()
    # 若启用了 OpenSSL 支持
    if(USE_OPENSSL)
      # 检查 OpenSSL 中是否存在 SSL_set1_ech_config_list 函数
      curl_openssl_check_exists("SSL_set1_ech_config_list" HAVE_SSL_SET1_ECH_CONFIG_LIST)
    endif()
    # 若 wolfSSL 或 OpenSSL 支持 ECH 或启用了 Rustls
    if(HAVE_WOLFSSL_CTX_GENERATEECHCONFIG OR
       HAVE_SSL_SET1_ECH_CONFIG_LIST OR
       USE_RUSTLS)
      # 标记支持 ECH
      set(HAVE_ECH 1)
    endif()
    # 若不支持 ECH
    if(NOT HAVE_ECH)
      # 输出错误信息并终止构建，提示 ECH 支持缺失
      message(FATAL_ERROR "ECH support missing in OpenSSL/BoringSSL/AWS-LC/wolfSSL/rustls-ffi")
    else()
      # 输出状态信息，提示 ECH 已启用
      message(STATUS "ECH enabled")
      # ECH 需要 HTTPS RR 支持，强制启用 HTTPS RR
      set(USE_HTTPSRR ON)
      # 输出状态信息，提示 HTTPS RR 已启用
      message(STATUS "HTTPSRR enabled")
    endif()
  else()
    # 输出错误信息并终止构建，提示 ECH 需要特定的 TLS 库支持
    message(FATAL_ERROR "ECH requires ECH-enabled OpenSSL, BoringSSL, AWS-LC, wolfSSL or rustls-ffi")
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否启用 SSL 会话导出支持，默认禁用
option(USE_SSLS_EXPORT "Enable SSL session export support" OFF)
# 若启用了 SSL 会话导出支持
if(USE_SSLS_EXPORT)
  # 若启用了 SSL 支持
  if(_ssl_enabled)
    # 输出状态信息，提示 SSL 导出已启用
    message(STATUS "SSL export enabled.")
  else()
    # 输出错误信息并终止构建，提示 SSL 会话导出需要启用 SSL
    message(FATAL_ERROR "SSL session export requires SSL enabled")
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否使用 nghttp2 库，默认启用
option(USE_NGHTTP2 "Use nghttp2 library" ON)
# 若启用使用 nghttp2 库
if(USE_NGHTTP2)
  # 查找 nghttp2 库
  find_package(NGHTTP2)
  # 若找到 nghttp2 库
  if(NGHTTP2_FOUND)
    # 将 nghttp2 库添加到 CURL 依赖库列表中
    list(APPEND CURL_LIBS ${NGHTTP2_LIBRARIES})
    # 将 nghttp2 库的路径添加到 CURL 库路径列表中
    list(APPEND CURL_LIBDIRS ${NGHTTP2_LIBRARY_DIRS})
    # 将 nghttp2 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
    list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${NGHTTP2_PC_REQUIRES})
    # 添加 nghttp2 头文件目录到系统包含路径
    include_directories(SYSTEM ${NGHTTP2_INCLUDE_DIRS})
    # 设置链接目录为 nghttp2 库的路径
    link_directories(${NGHTTP2_LIBRARY_DIRS})
    # 若 nghttp2 库有编译标志，将其添加到 C 编译器标志中
    if(NGHTTP2_CFLAGS)
      string(APPEND CMAKE_C_FLAGS " ${NGHTTP2_CFLAGS}")
    endif()
  else()
    # 若未找到 nghttp2 库，禁用使用 nghttp2 库
    set(USE_NGHTTP2 OFF)
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否使用 ngtcp2 和 nghttp3 库实现 HTTP/3 支持，默认禁用
option(USE_NGTCP2 "Use ngtcp2 and nghttp3 libraries for HTTP/3 support" OFF)
# 若启用使用 ngtcp2 和 nghttp3 库
if(USE_NGTCP2)
  # 若启用了 OpenSSL 或 wolfSSL 支持
  if(USE_OPENSSL OR USE_WOLFSSL)
    # 若启用了 wolfSSL 支持
    if(USE_WOLFSSL)
      # 查找 ngtcp2 库，要求支持 wolfSSL
      find_package(NGTCP2 REQUIRED "wolfSSL")
    # 若使用 BoringSSL 或 AWS-LC
    elseif(HAVE_BORINGSSL OR HAVE_AWSLC)
      # 查找 ngtcp2 库，要求支持 BoringSSL
      find_package(NGTCP2 REQUIRED "BoringSSL")
    else()
      # 查找 ngtcp2 库，要求支持 quictls
      find_package(NGTCP2 REQUIRED "quictls")
      # 若未使用 LibreSSL
      if(NOT HAVE_LIBRESSL)
        # 设置 _openssl 变量为 quictls
        set(_openssl "quictls")
      endif()
    endif()
    # 检查 OpenSSL 分支是否支持 QUIC
    curl_openssl_check_quic()
  # 若启用了 GnuTLS 支持
  elseif(USE_GNUTLS)
    # 查找 ngtcp2 库，要求支持 GnuTLS
    find_package(NGTCP2 REQUIRED "GnuTLS")
  else()
    # 输出错误信息并终止构建，提示 ngtcp2 需要 OpenSSL、wolfSSL 或 GnuTLS 支持
    message(FATAL_ERROR "ngtcp2 requires OpenSSL, wolfSSL or GnuTLS")
  endif()
  # 将 ngtcp2 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${NGTCP2_LIBRARIES})
  # 将 ngtcp2 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${NGTCP2_LIBRARY_DIRS})
  # 将 ngtcp2 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${NGTCP2_PC_REQUIRES})
  # 添加 ngtcp2 头文件目录到系统包含路径
  include_directories(SYSTEM ${NGTCP2_INCLUDE_DIRS})
  # 设置链接目录为 ngtcp2 库的路径
  link_directories(${NGTCP2_LIBRARY_DIRS})
  # 若 ngtcp2 库有编译标志，将其添加到 C 编译器标志中
  if(NGTCP2_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${NGTCP2_CFLAGS}")
  endif()

  # 查找 nghttp3 库，要求必须找到
  find_package(NGHTTP3 REQUIRED)
  # 启用使用 nghttp3 库
  set(USE_NGHTTP3 ON)
  # 将 nghttp3 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${NGHTTP3_LIBRARIES})
  # 将 nghttp3 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${NGHTTP3_LIBRARY_DIRS})
  # 将 nghttp3 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${NGHTTP3_PC_REQUIRES})
  # 添加 nghttp3 头文件目录到系统包含路径
  include_directories(SYSTEM ${NGHTTP3_INCLUDE_DIRS})
  # 设置链接目录为 nghttp3 库的路径
  link_directories(${NGHTTP3_LIBRARY_DIRS})
  # 若 nghttp3 库有编译标志，将其添加到 C 编译器标志中
  if(NGHTTP3_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${NGHTTP3_CFLAGS}")
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否使用 quiche 库实现 HTTP/3 支持，默认禁用
option(USE_QUICHE "Use quiche library for HTTP/3 support" OFF)
# 若启用使用 quiche 库
if(USE_QUICHE)
  # 若已启用使用 ngtcp2 库
  if(USE_NGTCP2)
    # 输出错误信息并终止构建，提示只能选择一个 HTTP/3 后端
    message(FATAL_ERROR "Only one HTTP/3 backend can be selected")
  endif()
  # 查找 quiche 库，要求必须找到
  find_package(Quiche REQUIRED)
  # 若未使用 BoringSSL
  if(NOT HAVE_BORINGSSL)
    # 输出错误信息并终止构建，提示 quiche 需要 BoringSSL 支持
    message(FATAL_ERROR "quiche requires BoringSSL")
  endif()
  # 检查 OpenSSL 分支是否支持 QUIC
  curl_openssl_check_quic()
  # 将 quiche 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${QUICHE_LIBRARIES})
  # 将 quiche 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${QUICHE_LIBRARY_DIRS})
  # 将 quiche 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${QUICHE_PC_REQUIRES})
  # 添加 quiche 头文件目录到系统包含路径
  include_directories(SYSTEM ${QUICHE_INCLUDE_DIRS})
  # 设置链接目录为 quiche 库的路径
  link_directories(${QUICHE_LIBRARY_DIRS})
  # 若 quiche 库有编译标志，将其添加到 C 编译器标志中
  if(QUICHE_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${QUICHE_CFLAGS}")
  endif()
  # 若未定义 HAVE_QUICHE_CONN_SET_QLOG_FD
  if(NOT DEFINED HAVE_QUICHE_CONN_SET_QLOG_FD)
    # 保存当前的检查状态
    cmake_push_check_state()
    # 将 quiche 头文件目录添加到特性检查的包含路径中
    list(APPEND CMAKE_REQUIRED_INCLUDES   "${QUICHE_INCLUDE_DIRS}")
    # 将 quiche 库添加到特性检查的依赖库列表中
    list(APPEND CMAKE_REQUIRED_LIBRARIES  "${QUICHE_LIBRARIES}")
    # 检查 quiche 中是否存在 quiche_conn_set_qlog_fd 符号
    check_symbol_exists("quiche_conn_set_qlog_fd" "quiche.h" HAVE_QUICHE_CONN_SET_QLOG_FD)
    # 恢复之前保存的检查状态
    cmake_pop_check_state()
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否使用 msh3/msquic 库实现 HTTP/3 支持，默认禁用
option(USE_MSH3 "Use msh3/msquic library for HTTP/3 support" OFF)
# 若启用使用 msh3/msquic 库
if(USE_MSH3)
  # 若已启用使用 ngtcp2 或 quiche 库
  if(USE_NGTCP2 OR USE_QUICHE)
    # 输出错误信息并终止构建，提示只能选择一个 HTTP/3 后端
    message(FATAL_ERROR "Only one HTTP/3 backend can be selected")
  endif()
  # 若当前非 Windows 平台
  if(NOT WIN32)
    # 若未启用 OpenSSL 支持
    if(NOT USE_OPENSSL)
      # 输出错误信息并终止构建，提示 msh3/msquic 需要支持 QUIC API 的 OpenSSL 分支
      message(FATAL_ERROR "msh3/msquic requires OpenSSL fork with QUIC API")
    endif()
    # 检查 OpenSSL 分支是否支持 QUIC
    curl_openssl_check_quic()
  endif()
  # 查找 msh3 库，要求必须找到
  find_package(MSH3 REQUIRED)
  # 将 msh3 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${MSH3_LIBRARIES})
  # 将 msh3 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${MSH3_LIBRARY_DIRS})
  # 将 msh3 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${MSH3_PC_REQUIRES})
  # 添加 msh3 头文件目录到系统包含路径
  include_directories(SYSTEM ${MSH3_INCLUDE_DIRS})
  # 设置链接目录为 msh3 库的路径
  link_directories(${MSH3_LIBRARY_DIRS})
  # 若 msh3 库有编译标志，将其添加到 C 编译器标志中
  if(MSH3_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${MSH3_CFLAGS}")
  endif()
endif()

# 若启用 OpenSSL QUIC 支持
if(USE_OPENSSL_QUIC)
  # 若已启用使用 ngtcp2、quiche 或 msh3/msquic 库
  if(USE_NGTCP2 OR USE_QUICHE OR USE_MSH3)
    # 输出错误信息并终止构建，提示只能选择一个 HTTP/3 后端
    message(FATAL_ERROR "Only one HTTP/3 backend can be selected")
  endif()
  # 查找 OpenSSL 3.3.0 或更高版本，要求必须找到
  find_package(OpenSSL 3.3.0 REQUIRED)

  # 查找 nghttp3 库，要求必须找到
  find_package(NGHTTP3 REQUIRED)
  # 启用使用 nghttp3 库
  set(USE_NGHTTP3 ON)
  # 添加 nghttp3 头文件目录到系统包含路径
  include_directories(SYSTEM ${NGHTTP3_INCLUDE_DIRS})
  # 将 nghttp3 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${NGHTTP3_LIBRARIES})
  # 将 nghttp3 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${NGHTTP3_PC_REQUIRES})
endif()

# 若启用多 SSL 支持且启用了任何 HTTP/3 后端
if(CURL_WITH_MULTI_SSL AND (USE_NGTCP2 OR USE_QUICHE OR USE_MSH3 OR USE_OPENSSL_QUIC))
  # 输出错误信息并终止构建，提示多 SSL 支持和 HTTP/3 支持不能同时启用
  message(FATAL_ERROR "MultiSSL cannot be enabled with HTTP/3 and vice versa.")
endif()

# 若未禁用 SRP 支持且 GnuTLS 或 OpenSSL 支持 SRP
if(NOT CURL_DISABLE_SRP AND (HAVE_GNUTLS_SRP OR HAVE_OPENSSL_SRP))
  # 标记启用 TLS SRP 支持
  set(USE_TLS_SRP 1)
endif()

# 若未禁用 LDAP 支持
if(NOT CURL_DISABLE_LDAP)
  # 若当前为 Windows 平台且非 Windows Store 应用和 Windows CE
  if(WIN32 AND NOT WINDOWS_STORE AND NOT WINCE)
    # 定义一个 CMake 选项，用于控制是否使用 Windows LDAP 实现，默认启用
    option(USE_WIN32_LDAP "Use Windows LDAP implementation" ON)
    # 若启用使用 Windows LDAP 实现
    if(USE_WIN32_LDAP)
      # 将 wldap32 库添加到 CURL 依赖库列表中
      list(APPEND CURL_LIBS "wldap32")
      # 若未禁用 LDAPS 支持
      if(NOT CURL_DISABLE_LDAPS)
        # 标记支持 LDAP SSL
        set(HAVE_LDAP_SSL ON)
      endif()
    endif()
  endif()

    # 现在我们知道不使用 Windows LDAP 实现...
  if(NOT USE_WIN32_LDAP)
    # 检查 LDAP 库
    cmake_push_check_state()
    # 若启用了 OpenSSL 支持，将 OpenSSL 相关库添加到特性检查的依赖库列表中
    if(USE_OPENSSL)
      list(APPEND CMAKE_REQUIRED_LIBRARIES OpenSSL::SSL OpenSSL::Crypto)
    endif()
    # 查找 LDAP 库
    find_package(LDAP)
    # 若找到 LDAP 库
    if(LDAP_FOUND)
      # 标记找到 lber.h 头文件
      set(HAVE_LBER_H 1)
      # 将 LDAP 库添加到 CURL 依赖库列表的前面
      set(CURL_LIBS ${LDAP_LIBRARIES} ${CURL_LIBS})
      # 将 LDAP 库的路径添加到 CURL 库路径列表中
      list(APPEND CURL_LIBDIRS ${LDAP_LIBRARY_DIRS})
      # 若 LDAP 库有 pkg-config 依赖项名称，将其添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表的前面
      if(LDAP_PC_REQUIRES)
        set(LIBCURL_PC_REQUIRES_PRIVATE ${LDAP_PC_REQUIRES} ${LIBCURL_PC_REQUIRES_PRIVATE})
      endif()
      # 添加 LDAP 头文件目录到系统包含路径
      include_directories(SYSTEM ${LDAP_INCLUDE_DIRS})
      # 设置链接目录为 LDAP 库的路径
      link_directories(${LDAP_LIBRARY_DIRS})
      # 若 LDAP 库有编译标志，将其添加到 C 编译器标志中
      if(LDAP_CFLAGS)
        string(APPEND CMAKE_C_FLAGS " ${LDAP_CFLAGS}")
      endif()

      # LDAP 特性检查

      # 添加编译定义，标记 LDAP 弃用函数可用
      list(APPEND CMAKE_REQUIRED_DEFINITIONS "-DLDAP_DEPRECATED=1")
      # 将 LDAP 库添加到特性检查的依赖库列表中
      list(APPEND CMAKE_REQUIRED_LIBRARIES ${LDAP_LIBRARIES})
      # 调用自定义函数设置 LDAP 库的路径
      curl_required_libpaths("${LDAP_LIBRARY_DIRS}")

      # 检查 ldap_url_parse 函数是否存在
      check_function_exists("ldap_url_parse" HAVE_LDAP_URL_PARSE)
      # 检查 ldap_init_fd 函数是否存在
      check_function_exists("ldap_init_fd" HAVE_LDAP_INIT_FD)

      # 检查 ldap_ssl.h 头文件是否存在
      check_include_file("ldap_ssl.h" HAVE_LDAP_SSL_H)

      # 若存在 ldap_init_fd 函数，启用 OpenLDAP 支持
      if(HAVE_LDAP_INIT_FD)
        set(USE_OPENLDAP ON)
      endif()
      # 若未禁用 LDAPS 支持，标记支持 LDAP SSL
      if(NOT CURL_DISABLE_LDAPS)
        set(HAVE_LDAP_SSL ON)
      endif()
    else()
      # 若未找到 LDAP 库，输出状态信息并强制禁用 LDAP 支持
      message(STATUS "LDAP not found. CURL_DISABLE_LDAP set ON")
      set(CURL_DISABLE_LDAP ON CACHE BOOL "" FORCE)
    endif()
    # 恢复之前保存的检查状态
    cmake_pop_check_state()
  endif()
endif()

# 若禁用了 LDAP 支持，也必须禁用 LDAPS 支持
if(CURL_DISABLE_LDAP)
  if(NOT CURL_DISABLE_LDAPS)
    # 输出状态信息提示需要启用 LDAP 才能支持 LDAPS
    message(STATUS "LDAP needs to be enabled to support LDAPS")
    # 强制禁用 LDAPS 支持
    set(CURL_DISABLE_LDAPS ON CACHE BOOL "" FORCE)
  endif()
endif()

# 若当前为 Windows 平台
if(WIN32)
  # 定义一个 CMake 选项，用于控制是否使用 WinIDN 实现 IDN 支持，默认禁用
  option(USE_WIN32_IDN "Use WinIDN for IDN support" OFF)
  # 若启用使用 WinIDN 实现 IDN 支持
  if(USE_WIN32_IDN)
    # 将 normaliz 库添加到 CURL 依赖库列表中
    list(APPEND CURL_LIBS "normaliz")
  endif()
else()
  # 若当前非 Windows 平台，禁用使用 WinIDN 实现 IDN 支持
  set(USE_WIN32_IDN OFF)
endif()

# 若当前为 Apple 平台
if(APPLE)
  # 定义一个 CMake 选项，用于控制是否使用 Apple 内置的 IDN 支持，默认禁用
  option(USE_APPLE_IDN "Use Apple built-in IDN support" OFF)
  # 若启用使用 Apple 内置的 IDN 支持
  if(USE_APPLE_IDN)
    # 保存当前的检查状态
    cmake_push_check_state()
    # 将 icucore 库添加到特性检查的依赖库列表中
    list(APPEND CMAKE_REQUIRED_LIBRARIES "icucore")
    # 检查 uidna_openUTS46 符号是否存在
    check_symbol_exists("uidna_openUTS46" "unicode/uidna.h" HAVE_APPLE_IDN)
    # 恢复之前保存的检查状态
    cmake_pop_check_state()
    # 若存在 uidna_openUTS46 符号
    if(HAVE_APPLE_IDN)
      # 将 icucore 和 iconv 库添加到 CURL 依赖库列表中
      list(APPEND CURL_LIBS "icucore" "iconv")
    else()
      # 若不存在 uidna_openUTS46 符号，禁用使用 Apple 内置的 IDN 支持
      set(USE_APPLE_IDN OFF)
    endif()
  endif()
else()
  # 若当前非 Apple 平台，禁用使用 Apple 内置的 IDN 支持
  set(USE_APPLE_IDN OFF)
endif()

# 检查 libidn2 库
# 定义一个 CMake 选项，用于控制是否使用 libidn2 实现 IDN 支持，默认启用
option(USE_LIBIDN2 "Use libidn2 for IDN support" ON)
# 初始化 HAVE_IDN2_H 变量为 OFF，表示未找到 idn2.h 头文件
set(HAVE_IDN2_H OFF)
# 初始化 HAVE_LIBIDN2 变量为 OFF，表示未找到 libidn2 库
set(HAVE_LIBIDN2 OFF)
# 若启用使用 libidn2 实现 IDN 支持，且未使用 Apple 内置 IDN 支持和 WinIDN 支持
if(USE_LIBIDN2 AND NOT USE_APPLE_IDN AND NOT USE_WIN32_IDN)
  # 查找 libidn2 库
  find_package(Libidn2)
  # 若找到 libidn2 库
  if(LIBIDN2_FOUND)
    # 将 libidn2 库添加到 CURL 依赖库列表的前面
    set(CURL_LIBS ${LIBIDN2_LIBRARIES} ${CURL_LIBS})
    # 将 libidn2 库的路径添加到 CURL 库路径列表中
    list(APPEND CURL_LIBDIRS ${LIBIDN2_LIBRARY_DIRS})
    # 将 libidn2 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表的前面
    set(LIBCURL_PC_REQUIRES_PRIVATE ${LIBIDN2_PC_REQUIRES} ${LIBCURL_PC_REQUIRES_PRIVATE})
    # 添加 libidn2 头文件目录到系统包含路径
    include_directories(SYSTEM ${LIBIDN2_INCLUDE_DIRS})
    # 设置链接目录为 libidn2 库的路径
    link_directories(${LIBIDN2_LIBRARY_DIRS})
    # 若 libidn2 库有编译标志，将其添加到 C 编译器标志中
    if(LIBIDN2_CFLAGS)
      string(APPEND CMAKE_C_FLAGS " ${LIBIDN2_CFLAGS}")
    endif()
    # 标记找到 idn2.h 头文件
    set(HAVE_IDN2_H 1)
    # 标记找到 libidn2 库
    set(HAVE_LIBIDN2 1)
  endif()
endif()

# libpsl
# 定义一个 CMake 选项，用于控制是否使用 libpsl，默认启用
option(CURL_USE_LIBPSL "Use libpsl" ON)
# 将该选项标记为高级选项
mark_as_advanced(CURL_USE_LIBPSL)
# 初始化 USE_LIBPSL 变量为 OFF，表示不使用 libpsl
set(USE_LIBPSL OFF)

# 若启用使用 libpsl
if(CURL_USE_LIBPSL)
  # 查找 libpsl 库，若未找到则报错
  find_package(Libpsl REQUIRED)
  # 将 libpsl 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${LIBPSL_LIBRARIES})
  # 将 libpsl 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${LIBPSL_LIBRARY_DIRS})
  # 将 libpsl 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${LIBPSL_PC_REQUIRES})
  # 添加 libpsl 头文件目录到系统包含路径
  include_directories(SYSTEM ${LIBPSL_INCLUDE_DIRS})
  # 设置链接目录为 libpsl 库的路径
  link_directories(${LIBPSL_LIBRARY_DIRS})
  # 若 libpsl 库有编译标志，将其添加到 C 编译器标志中
  if(LIBPSL_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${LIBPSL_CFLAGS}")
  endif()
  # 标记使用 libpsl
  set(USE_LIBPSL ON)
endif()

# libssh2
# 定义一个 CMake 选项，用于控制是否使用 libssh2，默认启用
option(CURL_USE_LIBSSH2 "Use libssh2" ON)
# 将该选项标记为高级选项
mark_as_advanced(CURL_USE_LIBSSH2)
# 初始化 USE_LIBSSH2 变量为 OFF，表示不使用 libssh2
set(USE_LIBSSH2 OFF)

# 若启用使用 libssh2
if(CURL_USE_LIBSSH2)
  # 查找 libssh2 库
  find_package(Libssh2)
  # 若找到 libssh2 库
  if(LIBSSH2_FOUND)
    # 将 libssh2 库添加到 CURL 依赖库列表的前面（保持在 TLS 加密库、压缩库之前）
    set(CURL_LIBS ${LIBSSH2_LIBRARIES} ${CURL_LIBS})
    # 将 libssh2 库的路径添加到 CURL 库路径列表中
    list(APPEND CURL_LIBDIRS ${LIBSSH2_LIBRARY_DIRS})
    # 将 libssh2 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表的前面
    set(LIBCURL_PC_REQUIRES_PRIVATE ${LIBSSH2_PC_REQUIRES} ${LIBCURL_PC_REQUIRES_PRIVATE})
    # 添加 libssh2 头文件目录到系统包含路径
    include_directories(SYSTEM ${LIBSSH2_INCLUDE_DIRS})
    # 设置链接目录为 libssh2 库的路径
    link_directories(${LIBSSH2_LIBRARY_DIRS})
    # 若 libssh2 库有编译标志，将其添加到 C 编译器标志中
    if(LIBSSH2_CFLAGS)
      string(APPEND CMAKE_C_FLAGS " ${LIBSSH2_CFLAGS}")
    endif()
    # 标记使用 libssh2
    set(USE_LIBSSH2 ON)
  endif()
endif()

# libssh
# 定义一个 CMake 选项，用于控制是否使用 libssh，默认禁用
option(CURL_USE_LIBSSH "Use libssh" OFF)
# 将该选项标记为高级选项
mark_as_advanced(CURL_USE_LIBSSH)
# 若未使用 libssh2 且启用使用 libssh
if(NOT USE_LIBSSH2 AND CURL_USE_LIBSSH)
  # 查找 libssh 库，若未找到则报错
  find_package(Libssh REQUIRED)
  # 将 libssh 库添加到 CURL 依赖库列表的前面（保持在 TLS 加密库、压缩库之前）
  set(CURL_LIBS ${LIBSSH_LIBRARIES} ${CURL_LIBS})
  # 将 libssh 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${LIBSSH_LIBRARY_DIRS})
  # 将 libssh 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表的前面
  set(LIBCURL_PC_REQUIRES_PRIVATE ${LIBSSH_PC_REQUIRES} ${LIBCURL_PC_REQUIRES_PRIVATE})
  # 添加 libssh 头文件目录到系统包含路径
  include_directories(SYSTEM ${LIBSSH_INCLUDE_DIRS})
  # 设置链接目录为 libssh 库的路径
  link_directories(${LIBSSH_LIBRARY_DIRS})
  # 若 libssh 库有编译标志，将其添加到 C 编译器标志中
  if(LIBSSH_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${LIBSSH_CFLAGS}")
  endif()
  # 标记使用 libssh
  set(USE_LIBSSH ON)
endif()

# wolfSSH
# 定义一个 CMake 选项，用于控制是否使用 wolfSSH，默认禁用
option(CURL_USE_WOLFSSH "Use wolfSSH" OFF)
# 将该选项标记为高级选项
mark_as_advanced(CURL_USE_WOLFSSH)
# 初始化 USE_WOLFSSH 变量为 OFF，表示不使用 wolfSSH
set(USE_WOLFSSH OFF)
# 若未使用 libssh2 和 libssh 且启用使用 wolfSSH
if(NOT USE_LIBSSH2 AND NOT USE_LIBSSH AND CURL_USE_WOLFSSH)
  # 若启用了 wolfSSL 支持
  if(USE_WOLFSSL)
    # 查找 wolfSSH 库
    find_package(WolfSSH)
    # 若找到 wolfSSH 库
    if(WOLFSSH_FOUND)
      # 将 wolfSSH 库添加到 CURL 依赖库列表的前面（保持在 TLS 加密库、压缩库之前）
      set(CURL_LIBS ${WOLFSSH_LIBRARIES} ${CURL_LIBS})
      # 添加 wolfSSH 头文件目录到系统包含路径
      include_directories(SYSTEM ${WOLFSSH_INCLUDE_DIRS})
      # 标记使用 wolfSSH
      set(USE_WOLFSSH ON)
    endif()
  else()
    # 若未启用 wolfSSL 支持，输出警告信息并跳过
    message(WARNING "wolfSSH requires wolfSSL. Skipping.")
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否使用 libgsasl，默认禁用
option(CURL_USE_GSASL "Use libgsasl" OFF)
# 将该选项标记为高级选项
mark_as_advanced(CURL_USE_GSASL)
# 若启用使用 libgsasl
if(CURL_USE_GSASL)
  # 查找 libgsasl 库，若未找到则报错
  find_package(Libgsasl REQUIRED)
  # 将 libgsasl 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${LIBGSASL_LIBRARIES})
  # 将 libgsasl 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${LIBGSASL_LIBRARY_DIRS})
  # 将 libgsasl 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${LIBGSASL_PC_REQUIRES})
  # 添加 libgsasl 头文件目录到系统包含路径
  include_directories(SYSTEM ${LIBGSASL_INCLUDE_DIRS})
  # 设置链接目录为 libgsasl 库的路径
  link_directories(${LIBGSASL_LIBRARY_DIRS})
  # 若 libgsasl 库有编译标志，将其添加到 C 编译器标志中
  if(LIBGSASL_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${LIBGSASL_CFLAGS}")
  endif()
  # 标记使用 libgsasl
  set(USE_GSASL ON)
endif()

# 定义一个 CMake 选项，用于控制是否使用 GSSAPI 实现，默认禁用
option(CURL_USE_GSSAPI "Use GSSAPI implementation" OFF)
# 将该选项标记为高级选项
mark_as_advanced(CURL_USE_GSSAPI)

# 若启用使用 GSSAPI 实现
if(CURL_USE_GSSAPI)
  # 查找 GSS 库
  find_package(GSS)

  # 标记是否找到 GSSAPI 库
  set(HAVE_GSSAPI ${GSS_FOUND})
  # 若找到 GSS 库
  if(GSS_FOUND)
    # 将 GSS 库添加到 CURL 依赖库列表中
    list(APPEND CURL_LIBS ${GSS_LIBRARIES})
    # 将 GSS 库的路径添加到 CURL 库路径列表中
    list(APPEND CURL_LIBDIRS ${GSS_LIBRARY_DIRS})
    # 将 GSS 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
    list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${GSS_PC_REQUIRES})
    # 添加 GSS 头文件目录到系统包含路径
    include_directories(SYSTEM ${GSS_INCLUDE_DIRS})
    # 设置链接目录为 GSS 库的路径
    link_directories(${GSS_LIBRARY_DIRS})
    # 若 GSS 库有编译标志，将其添加到 C 编译器标志中
    if(GSS_CFLAGS)
      string(APPEND CMAKE_C_FLAGS " ${GSS_CFLAGS}")
    endif()

    # 若 GSS 库的风格为 GNU
    if(GSS_FLAVOUR STREQUAL "GNU")
      # 标记使用 GNU 风格的 GSSAPI
      set(HAVE_GSSGNU 1)
    else()
      # 保存当前的检查状态
      cmake_push_check_state()
      # 将 GSS 头文件目录添加到特性检查的包含路径中
      list(APPEND CMAKE_REQUIRED_INCLUDES ${GSS_INCLUDE_DIRS})

      # 初始化包含文件列表
      set(_include_list "")
      # 检查 gssapi/gssapi.h 头文件是否存在
      check_include_file("gssapi/gssapi.h" HAVE_GSSAPI_GSSAPI_H)
      # 若存在 gssapi/gssapi.h 头文件，将其添加到包含文件列表中
      if(HAVE_GSSAPI_GSSAPI_H)
        list(APPEND _include_list "gssapi/gssapi.h")
      endif()
      # 检查 gssapi/gssapi_generic.h 头文件是否存在
      check_include_files("${_include_list};gssapi/gssapi_generic.h" HAVE_GSSAPI_GSSAPI_GENERIC_H)

      # 若 GSS 库的风格为 MIT
      if(GSS_FLAVOUR STREQUAL "MIT")
        # 检查 gssapi/gssapi_krb5.h 头文件是否存在
        check_include_files("${_include_list};gssapi/gssapi_krb5.h" _have_gssapi_gssapi_krb5_h)
        # 若存在 gssapi/gssapi_generic.h 头文件，将其添加到包含文件列表中
        if(HAVE_GSSAPI_GSSAPI_GENERIC_H)
          list(APPEND _include_list "gssapi/gssapi_generic.h")
        endif()
        # 若存在 gssapi/gssapi_krb5.h 头文件，将其添加到包含文件列表中
        if(_have_gssapi_gssapi_krb5_h)
          list(APPEND _include_list "gssapi/gssapi_krb5.h")
        endif()

        # 若未定义 HAVE_GSS_C_NT_HOSTBASED_SERVICE
        if(NOT DEFINED HAVE_GSS_C_NT_HOSTBASED_SERVICE)
          # 将 GSS 库的编译标志添加到特性检查的编译标志中
          string(APPEND CMAKE_REQUIRED_FLAGS " ${GSS_CFLAGS}")
          # 将 GSS 库添加到特性检查的依赖库列表中
          list(APPEND CMAKE_REQUIRED_LIBRARIES ${GSS_LIBRARIES})
          # 调用自定义函数设置 GSS 库的路径
          curl_required_libpaths("${GSS_LIBRARY_DIRS}")
          # 检查 GSS_C_NT_HOSTBASED_SERVICE 符号是否存在
          check_symbol_exists("GSS_C_NT_HOSTBASED_SERVICE" "${_include_list}" HAVE_GSS_C_NT_HOSTBASED_SERVICE)
        endif()
        # 若不存在 GSS_C_NT_HOSTBASED_SERVICE 符号，标记使用旧版本的 MIT GSSAPI
        if(NOT HAVE_GSS_C_NT_HOSTBASED_SERVICE)
          set(HAVE_OLD_GSSMIT ON)
        endif()
      endif()
      # 清除包含文件列表变量
      unset(_include_list)
      # 恢复之前保存的检查状态
      cmake_pop_check_state()
    endif()
  else()
    # 若未找到 GSS 库，输出警告信息并跳过
    message(WARNING "GSSAPI has been requested, but no supporting libraries found. Skipping.")
  endif()
endif()

# libuv
# 定义一个 CMake 选项，用于控制是否使用 libuv 进行基于事件的测试，默认禁用
option(CURL_USE_LIBUV "Use libuv for event-based tests" OFF)
# 若启用使用 libuv 进行基于事件的测试
if(CURL_USE_LIBUV)
  # 若未启用调试支持，输出错误信息并终止构建
  if(NOT ENABLE_DEBUG)
    message(FATAL_ERROR "Using libuv without debug support enabled is useless")
  endif()
  # 查找 libuv 库，若未找到则报错
  find_package(Libuv REQUIRED)
  # 将 libuv 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${LIBUV_LIBRARIES})
  # 将 libuv 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${LIBUV_LIBRARY_DIRS})
  # 将 libuv 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${LIBUV_PC_REQUIRES})
  # 添加 libuv 头文件目录到系统包含路径
  include_directories(SYSTEM ${LIBUV_INCLUDE_DIRS})
  # 设置链接目录为 libuv 库的路径
  link_directories(${LIBUV_LIBRARY_DIRS})
  # 若 libuv 库有编译标志，将其添加到 C 编译器标志中
  if(LIBUV_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${LIBUV_CFLAGS}")
  endif()
  # 标记使用 libuv
  set(USE_LIBUV ON)
  # 标记找到 uv.h 头文件
  set(HAVE_UV_H ON)
endif()

# 定义一个 CMake 选项，用于控制是否启用 rtmpdump 中的 librtmp，默认禁用
option(USE_LIBRTMP "Enable librtmp from rtmpdump" OFF)
# 若启用使用 librtmp
if(USE_LIBRTMP)
  # 查找 librtmp 库，若未找到则报错
  find_package(Librtmp REQUIRED)
  # 将 librtmp 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS ${LIBRTMP_LIBRARIES})
  # 将 librtmp 库的路径添加到 CURL 库路径列表中
  list(APPEND CURL_LIBDIRS ${LIBRTMP_LIBRARY_DIRS})
  # 将 librtmp 库的 pkg-config 依赖项名称添加到 LIBCURL_PC_REQUIRES_PRIVATE 列表中
  list(APPEND LIBCURL_PC_REQUIRES_PRIVATE ${LIBRTMP_PC_REQUIRES})
  # 添加 librtmp 头文件目录到系统包含路径
  include_directories(SYSTEM ${LIBRTMP_INCLUDE_DIRS})
  # 设置链接目录为 librtmp 库的路径
  link_directories(${LIBRTMP_LIBRARY_DIRS})
  # 若 librtmp 库有编译标志，将其添加到 C 编译器标志中
  if(LIBRTMP_CFLAGS)
    string(APPEND CMAKE_C_FLAGS " ${LIBRTMP_CFLAGS}")
  endif()
endif()

# 定义一个 CMake 选项，用于控制是否启用 Unix 域套接字支持，默认启用
option(ENABLE_UNIX_SOCKETS "Enable Unix domain sockets support" ON)
# 若启用 Unix 域套接字支持且非 Windows CE 平台
if(ENABLE_UNIX_SOCKETS AND NOT WINCE)
  # 若当前为 Windows 或 DOS 平台
  if(WIN32 OR DOS)
    # 标记支持 Unix 域套接字
    set(USE_UNIX_SOCKETS ON)
  else()
    # 包含 CheckStructHasMember 模块，用于检查结构体成员是否存在
    include(CheckStructHasMember)
    # 检查 struct sockaddr_un 结构体中是否存在 sun_path 成员，根据结果设置 USE_UNIX_SOCKETS 变量
    check_struct_has_member("struct sockaddr_un" "sun_path" "sys/un.h" USE_UNIX_SOCKETS)
  endif()
else()
  # 从缓存中移除 USE_UNIX_SOCKETS 变量
  unset(USE_UNIX_SOCKETS CACHE)
endif()

#
# CA 处理
#
# 若支持 CA 证书包
if(_curl_ca_bundle_supported)
  # 定义一个 CMake 缓存变量，用于指定 CA 证书包的路径，支持 'none' 禁用、'auto' 自动检测，默认自动检测
  set(CURL_CA_BUNDLE "auto" CACHE
    STRING "Path to the CA bundle. Set 'none' to disable or 'auto' for auto-detection. Defaults to 'auto'.")
  # 定义一个 CMake 缓存布尔变量，用于控制是否使用 TLS 后端的内置 CA 存储，默认禁用
  set(CURL_CA_FALLBACK OFF CACHE
    BOOL "Use built-in CA store of TLS backend. Defaults to OFF")
  # 定义一个 CMake 缓存变量，用于指定默认 CA 路径的位置，支持 'none' 禁用、'auto' 自动检测，默认自动检测
  set(CURL_CA_PATH "auto" CACHE
    STRING "Location of default CA path. Set 'none' to disable or 'auto' for auto-detection. Defaults to 'auto'.")
  # 定义一个 CMake 缓存变量，用于指定要嵌入到 curl 工具中的 CA 证书包路径
  set(CURL_CA_EMBED "" CACHE
    STRING "Path to the CA bundle to embed in the curl tool.")

  # 若 CURL_CA_BUNDLE 变量为空
  if(CURL_CA_BUNDLE STREQUAL "")
    # 输出错误信息并终止构建，提示 CURL_CA_BUNDLE 值无效
    message(FATAL_ERROR "Invalid value of CURL_CA_BUNDLE. Use 'none', 'auto' or file path.")
  # 若 CURL_CA_BUNDLE 变量值为 'none'
  elseif(CURL_CA_BUNDLE STREQUAL "none")
    # 从缓存中移除 CURL_CA_BUNDLE 变量
    unset(CURL_CA_BUNDLE CACHE)
  # 若 CURL_CA_BUNDLE 变量值为 'auto'
  elseif(CURL_CA_BUNDLE STREQUAL "auto")
    # 从缓存中移除 CURL_CA_BUNDLE 变量
    unset(CURL_CA_BUNDLE CACHE)
    # 若当前非交叉编译环境且非 Windows 平台
    if(NOT CMAKE_CROSSCOMPILING AND NOT WIN32)
      # 标记需要自动检测 CA 证书包
      set(_curl_ca_bundle_autodetect TRUE)
    endif()
  else()
    # 标记 CA 证书包路径已设置
    set(CURL_CA_BUNDLE_SET TRUE)
  endif()
  # 将 CURL_CA_BUNDLE_SET 变量标记为高级选项
  mark_as_advanced(CURL_CA_BUNDLE_SET)

  # 若 CURL_CA_PATH 变量为空
  if(CURL_CA_PATH STREQUAL "")
    # 输出错误信息并终止构建，提示 CURL_CA_PATH 值无效
    message(FATAL_ERROR "Invalid value of CURL_CA_PATH. Use 'none', 'auto' or directory path.")
  # 若 CURL_CA_PATH 变量值为 'none'
  elseif(CURL_CA_PATH STREQUAL "none")
    # 从缓存中移除 CURL_CA_PATH 变量
    unset(CURL_CA_PATH CACHE)
  # 若 CURL_CA_PATH 变量值为 'auto'
  elseif(CURL_CA_PATH STREQUAL "auto")
    # 从缓存中移除 CURL_CA_PATH 变量
    unset(CURL_CA_PATH CACHE)
    # 若当前非交叉编译环境且非 Windows 平台
    if(NOT CMAKE_CROSSCOMPILING AND NOT WIN32)
      # 标记需要自动检测 CA 路径
      set(_curl_ca_path_autodetect TRUE)
    endif()
  else()
    # 标记 CA 路径已设置
    set(CURL_CA_PATH_SET TRUE)
  endif()
  # 将 CURL_CA_PATH_SET 变量标记为高级选项
  mark_as_advanced(CURL_CA_PATH_SET)

  # 若 CA 证书包路径已设置且需要自动检测 CA 路径
  if(CURL_CA_BUNDLE_SET AND _curl_ca_path_autodetect)
    # 由于 CA 证书包路径已明确设置，跳过未设置的 CA 路径的自动检测
  # 若 CA 路径已设置且需要自动检测 CA 证书包
  elseif(CURL_CA_PATH_SET AND _curl_ca_bundle_autodetect)
    # 由于 CA 路径已明确设置，跳过未设置的 CA 证书包的自动检测
  # 若需要自动检测 CA 证书包或 CA 路径
  elseif(_curl_ca_bundle_autodetect OR _curl_ca_path_autodetect)
    # 先尝试自动检测 CA 证书包，再尝试自动检测 CA 路径

    # 若需要自动检测 CA 证书包
    if(_curl_ca_bundle_autodetect)
      # 遍历预定义的 CA 证书包搜索路径
      foreach(_search_ca_bundle_path IN ITEMS
          "/etc/ssl/certs/ca-certificates.crt"
          "/etc/pki/tls/certs/ca-bundle.crt"
          "/usr/share/ssl/certs/ca-bundle.crt"
          "/usr/local/share/certs/ca-root-nss.crt"
          "/etc/ssl/cert.pem")
        # 若该路径下的 CA 证书包存在
        if(EXISTS "${_search_ca_bundle_path}")
          # 输出状态信息，提示找到 CA 证书包
          message(STATUS "Found CA bundle: ${_search_ca_bundle_path}")
          # 设置 CURL_CA_BUNDLE 缓存变量为找到的 CA 证书包路径
          set(CURL_CA_BUNDLE "${_search_ca_bundle_path}" CACHE
            STRING "Path to the CA bundle. Set 'none' to disable or 'auto' for auto-detection. Defaults to 'auto'.")
          # 标记 CA 证书包路径已设置
          set(CURL_CA_BUNDLE_SET TRUE CACHE BOOL "Path to the CA bundle has been set")
          # 跳出循环
          break()
        endif()
      endforeach()
    endif()

    # 若需要自动检测 CA 路径且 CA 路径未设置
    if(_curl_ca_path_autodetect AND NOT CURL_CA_PATH_SET)
      # 设置默认搜索的 CA 路径
      set(_search_ca_path "/etc/ssl/certs")
      # 查找指定路径下符合特定命名规则的 CA 文件
      file(GLOB _curl_ca_files_found "${_search_ca_path}/[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f].0")
      # 若找到符合条件的 CA 文件
      if(_curl_ca_files_found)
        # 清除 _curl_ca_files_found 变量
        unset(_curl_ca_files_found)
        # 输出状态信息，提示找到 CA 路径
        message(STATUS "Found CA path: ${_search_ca_path}")
        # 设置 CURL_CA_PATH 缓存变量为找到的 CA 路径
        set(CURL_CA_PATH "${_search_ca_path}" CACHE
          STRING "Location of default CA path. Set 'none' to disable or 'auto' for auto-detection. Defaults to 'auto'.")
        # 标记 CA 路径已设置
        set(CURL_CA_PATH_SET TRUE CACHE BOOL "Path to the CA bundle has been set")
      endif()
    endif()
  endif()

  # 初始化 CURL_CA_EMBED_SET 变量为 FALSE，表示未设置要嵌入的 CA 证书包
  set(CURL_CA_EMBED_SET FALSE)
  # 若构建 curl 可执行文件且 CURL_CA_EMBED 变量不为空
  if(BUILD_CURL_EXE AND NOT CURL_CA_EMBED STREQUAL "")
    # 若指定路径下的 CA 证书包存在
    if(EXISTS "${CURL_CA_EMBED}")
      # 标记要嵌入的 CA 证书包已设置
      set(CURL_CA_EMBED_SET TRUE)
      # 输出状态信息，提示找到要嵌入的 CA 证书包
      message(STATUS "Found CA bundle to embed: ${CURL_CA_EMBED}")
    else()
      # 输出错误信息并终止构建，提示要嵌入的 CA 证书包不存在
      message(FATAL_ERROR "CA bundle to embed is missing: '${CURL_CA_EMBED}'")
    endif()
  endif()
endif()

# 若当前为 Windows 平台
if(WIN32)
  # 定义一个 CMake 选项，用于控制是否禁用 Windows 上不安全的 CA 证书包搜索（在 PATH 中搜索），默认禁用
  option(CURL_DISABLE_CA_SEARCH "Disable unsafe CA bundle search in PATH on Windows" OFF)
  # 定义一个 CMake 选项，用于控制是否启用 Windows 上安全的 CA 证书包搜索（在 curl 工具目录内搜索），默认禁用
  option(CURL_CA_SEARCH_SAFE "Enable safe CA bundle search (within the curl tool directory) on Windows" OFF)
endif()

# 检查头文件
# 若当前为 Windows 平台
if(WIN32)
  # 将 winsock2.h 头文件添加到 CURL_INCLUDES 列表中
  list(APPEND CURL_INCLUDES "winsock2.h")
  # 将 ws2tcpip.h 头文件添加到 CURL_INCLUDES 列表中
  list(APPEND CURL_INCLUDES "ws2tcpip.h")

  # 若定义了 HAVE_WIN32_WINNT 变量且其值小于 0x0501（Windows XP 版本号），且非 Windows CE 平台
  if(HAVE_WIN32_WINNT AND HAVE_WIN32_WINNT LESS 0x0501 AND NOT WINCE)
    # 输出错误信息并终止构建，提示需要为 Windows XP 或更新版本构建
    message(FATAL_ERROR "Building for Windows XP or newer is required.")
  endif()
endif()

# 检测头文件

# 对后续 check_include_file_concat_curl() 或 check_symbol_exists() 检测所需的头文件使用 check_include_file_concat_curl()。
# 这些头文件的检测顺序很重要。
# 检查 sys/eventfd.h 头文件是否存在
check_include_file("sys/eventfd.h"    HAVE_SYS_EVENTFD_H)
# 检查 sys/filio.h 头文件是否存在
check_include_file("sys/filio.h"      HAVE_SYS_FILIO_H)
# 检查 sys/ioctl.h 头文件是否存在
check_include_file("sys/ioctl.h"      HAVE_SYS_IOCTL_H)
# 检查 sys/param.h 头文件是否存在
check_include_file("sys/param.h"      HAVE_SYS_PARAM_H)
# 检查 sys/poll.h 头文件是否存在
check_include_file("sys/poll.h"       HAVE_SYS_POLL_H)
# 检查 sys/resource.h 头文件是否存在
check_include_file("sys/resource.h"   HAVE_SYS_RESOURCE_H)
# 检查 sys/select.h 头文件是否存在
check_include_file_concat_curl("sys/select.h"     HAVE_SYS_SELECT_H)
# 检查 sys/socket.h 头文件是否存在
check_include_file_concat_curl("sys/socket.h"     HAVE_SYS_SOCKET_H)
# 检查 sys/sockio.h 头文件是否存在
check_include_file("sys/sockio.h"     HAVE_SYS_SOCKIO_H)
# 检查 sys/stat.h 头文件是否存在
check_include_file("sys/stat.h"       HAVE_SYS_STAT_H)
# 检查 sys/time.h 头文件是否存在
check_include_file_concat_curl("sys/time.h"       HAVE_SYS_TIME_H)
# 检查 sys/types.h 头文件是否存在
check_include_file_concat_curl("sys/types.h"      HAVE_SYS_TYPES_H)
# 检查 sys/un.h 头文件是否存在
check_include_file("sys/un.h"         HAVE_SYS_UN_H)
# 检查 sys/utime.h 头文件是否存在
check_include_file_concat_curl("sys/utime.h"      HAVE_SYS_UTIME_H)  # sys/types.h (AmigaOS)

# 检查 arpa/inet.h 头文件是否存在
check_include_file_concat_curl("arpa/inet.h"      HAVE_ARPA_INET_H)
# 检查 dirent.h 头文件是否存在
check_include_file("dirent.h"         HAVE_DIRENT_H)
# 检查 fcntl.h 头文件是否存在
check_include_file("fcntl.h"          HAVE_FCNTL_H)
# 检查 ifaddrs.h 头文件是否存在
check_include_file_concat_curl("ifaddrs.h"        HAVE_IFADDRS_H)
# 检查 io.h 头文件是否存在
check_include_file("io.h"             HAVE_IO_H)
# 检查 libgen.h 头文件是否存在
check_include_file_concat_curl("libgen.h"         HAVE_LIBGEN_H)
# 检查 linux/tcp.h 头文件是否存在
check_include_file("linux/tcp.h"      HAVE_LINUX_TCP_H)
# 检查 locale.h 头文件是否存在
check_include_file("locale.h"         HAVE_LOCALE_H)
# 检查 net/if.h 头文件是否存在
check_include_file_concat_curl("net/if.h"         HAVE_NET_IF_H)  # sys/select.h (e.g. MS-DOS/Watt-32)
# 检查 netdb.h 头文件是否存在
check_include_file_concat_curl("netdb.h"          HAVE_NETDB_H)
# 检查 netinet/in.h 头文件是否存在
check_include_file_concat_curl("netinet/in.h"     HAVE_NETINET_IN_H)
# 检查 netinet/in6.h 头文件是否存在
check_include_file("netinet/in6.h"    HAVE_NETINET_IN6_H)
# 检查 netinet/tcp.h 头文件是否存在
check_include_file_concat_curl("netinet/tcp.h"    HAVE_NETINET_TCP_H)  # sys/types.h (e.g. Cygwin) netinet/in.h
# 检查 netinet/udp.h 头文件是否存在
check_include_file_concat_curl("netinet/udp.h"    HAVE_NETINET_UDP_H)  # sys/types.h (e.g. Cygwin)
# 检查 poll.h 头文件是否存在
check_include_file("poll.h"           HAVE_POLL_H)
# 检查 pwd.h 头文件是否存在
check_include_file("pwd.h"            HAVE_PWD_H)
# 检查 stdatomic.h 头文件是否存在
check_include_file("stdatomic.h"      HAVE_STDATOMIC_H)
# 检查 stdbool.h 头文件是否存在
check_include_file("stdbool.h"        HAVE_STDBOOL_H)
# 检查 stdint.h 头文件是否存在
check_include_file("stdint.h"         HAVE_STDINT_H)
# 检查 strings.h 头文件是否存在
check_include_file("strings.h"        HAVE_STRINGS_H)
# 检查 stropts.h 头文件是否存在
check_include_file("stropts.h"        HAVE_STROPTS_H)
# 检查 termio.h 头文件是否存在
check_include_file("termio.h"         HAVE_TERMIO_H)
# 检查 termios.h 头文件是否存在
check_include_file("termios.h"        HAVE_TERMIOS_H)
# 检查 unistd.h 头文件是否存在
check_include_file_concat_curl("unistd.h"         HAVE_UNISTD_H)
# 检查 utime.h 头文件是否存在
check_include_file("utime.h"          HAVE_UTIME_H)

# 若当前为 Amiga 平台
if(AMIGA)
  # 检查 proto/bsdsocket.h 头文件是否存在
  check_include_file_concat_curl("proto/bsdsocket.h" HAVE_PROTO_BSDSOCKET_H)
endif()

# 将这些检测结果传递给 curl_internal_test()，供 CurlTests.c 使用
# 在此添加所有在 CurlTests.c 中引用的特性标志
foreach(_variable IN ITEMS
    HAVE_STDATOMIC_H
    HAVE_STDBOOL_H
    HAVE_STROPTS_H
    HAVE_SYS_IOCTL_H
    HAVE_SYS_SOCKET_H
    HAVE_SYS_TYPES_H
    HAVE_UNISTD_H
    )
  # 若该变量为真
  if(${_variable})
    # 将对应的编译定义添加到 CURL_TEST_DEFINES 变量中
    string(APPEND CURL_TEST_DEFINES " -D${_variable}")
  endif()
endforeach()

# 检查 size_t 类型的大小
check_type_size("size_t"      SIZEOF_SIZE_T)
# 检查 ssize_t 类型的大小
check_type_size("ssize_t"     SIZEOF_SSIZE_T)
# 检查 long long 类型的大小
check_type_size("long long"   SIZEOF_LONG_LONG)
# 检查 long 类型的大小
check_type_size("long"        SIZEOF_LONG)
# 检查 int 类型的大小
check_type_size("int"         SIZEOF_INT)
# 检查 __int64 类型的大小
check_type_size("__int64"     SIZEOF___INT64)
# 检查 time_t 类型的大小
check_type_size("time_t"      SIZEOF_TIME_T)
# 检查 suseconds_t 类型的大小
check_type_size("suseconds_t" SIZEOF_SUSECONDS_T)
# 若未检测到 ssize_t 类型的大小
if(NOT HAVE_SIZEOF_SSIZE_T)
  # 若 long 类型的大小等于 size_t 类型的大小
  if(SIZEOF_LONG EQUAL SIZEOF_SIZE_T)
    # 将 ssize_t 类型定义为 long
    set(ssize_t "long")
  endif()
  # 若 ssize_t 未定义且 __int64 类型的大小等于 size_t 类型的大小
  if(NOT ssize_t AND SIZEOF___INT64 EQUAL SIZEOF_SIZE_T)
    # 将 ssize_t 类型定义为 __int64
    set(ssize_t "__int64")
  endif()
endif()
# off_t 类型的大小在 HAVE_FILE_OFFSET_BITS 测试之后再确定

# 若检测到 long long 类型的大小
if(SIZEOF_LONG_LONG)
  # 标记支持 long long 类型
  set(HAVE_LONGLONG 1)
endif()
# 若检测到 suseconds_t 类型的大小
if(SIZEOF_SUSECONDS_T)
  # 标记支持 suseconds_t 类型
  set(HAVE_SUSECONDS_T 1)
endif()
# 检查一些会被使用的函数

# 应用到所有特性检查
if(WIN32)
  # 若为 Windows 平台，将 Winsock 库添加到特性检查所需的库列表中
  list(APPEND CMAKE_REQUIRED_LIBRARIES "${_win32_winsock}")
elseif(HAVE_LIBSOCKET)
  # 若存在 socket 库，将其添加到特性检查所需的库列表中
  list(APPEND CMAKE_REQUIRED_LIBRARIES "socket")
elseif(DOS)
  # 若为 DOS 平台，将 Watt-32 库添加到特性检查所需的库列表中
  list(APPEND CMAKE_REQUIRED_LIBRARIES "${WATT_ROOT}/lib/libwatt.a")
endif()

# 检查 fnmatch 函数是否存在
check_function_exists("fnmatch"       HAVE_FNMATCH)
# 检查 basename 符号是否存在，搜索包含 CURL_INCLUDES 和 string.h 的头文件
check_symbol_exists("basename"        "${CURL_INCLUDES};string.h" HAVE_BASENAME)  # libgen.h unistd.h
# 检查 opendir 符号是否存在，搜索 dirent.h 头文件
check_symbol_exists("opendir"         "dirent.h" HAVE_OPENDIR)
# 检查 poll 函数是否存在
check_function_exists("poll"          HAVE_POLL)  # poll.h
# 检查 socket 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("socket"          "${CURL_INCLUDES}" HAVE_SOCKET)  # winsock2.h sys/socket.h
# 检查 socketpair 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("socketpair"      "${CURL_INCLUDES}" HAVE_SOCKETPAIR)  # sys/socket.h
# 检查 recv 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("recv"            "${CURL_INCLUDES}" HAVE_RECV)  # proto/bsdsocket.h sys/types.h sys/socket.h
# 检查 send 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("send"            "${CURL_INCLUDES}" HAVE_SEND)  # proto/bsdsocket.h sys/types.h sys/socket.h
# 检查 sendmsg 函数是否存在
check_function_exists("sendmsg"       HAVE_SENDMSG)
# 检查 sendmmsg 函数是否存在
check_function_exists("sendmmsg"      HAVE_SENDMMSG)
# 检查 select 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("select"          "${CURL_INCLUDES}" HAVE_SELECT)  # proto/bsdsocket.h sys/select.h sys/socket.h
# 检查 strdup 符号是否存在，搜索 string.h 头文件
check_symbol_exists("strdup"          "string.h" HAVE_STRDUP)
# 检查 memrchr 符号是否存在，搜索 string.h 头文件
check_symbol_exists("memrchr"         "string.h" HAVE_MEMRCHR)
# 检查 alarm 符号是否存在，搜索 unistd.h 头文件
check_symbol_exists("alarm"           "unistd.h" HAVE_ALARM)
# 检查 fcntl 符号是否存在，搜索 fcntl.h 头文件
check_symbol_exists("fcntl"           "fcntl.h" HAVE_FCNTL)
# 检查 getppid 函数是否存在
check_function_exists("getppid"       HAVE_GETPPID)
# 检查 utimes 函数是否存在
check_function_exists("utimes"        HAVE_UTIMES)

# 检查 gettimeofday 函数是否存在，搜索 sys/time.h 头文件
check_function_exists("gettimeofday"  HAVE_GETTIMEOFDAY)  # sys/time.h
# 检查 closesocket 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("closesocket"     "${CURL_INCLUDES}" HAVE_CLOSESOCKET)  # winsock2.h
# 检查 sigsetjmp 符号是否存在，搜索 setjmp.h 头文件
check_symbol_exists("sigsetjmp"       "setjmp.h" HAVE_SIGSETJMP)
# 检查 getpass_r 函数是否存在
check_function_exists("getpass_r"     HAVE_GETPASS_R)
# 检查 getpwuid 函数是否存在
check_function_exists("getpwuid"      HAVE_GETPWUID)
# 检查 getpwuid_r 函数是否存在
check_function_exists("getpwuid_r"    HAVE_GETPWUID_R)
# 检查 geteuid 函数是否存在
check_function_exists("geteuid"       HAVE_GETEUID)
# 检查 utime 函数是否存在
check_function_exists("utime"         HAVE_UTIME)
# 检查 gmtime_r 符号是否存在，搜索 stdlib.h 和 time.h 头文件
check_symbol_exists("gmtime_r"        "stdlib.h;time.h" HAVE_GMTIME_R)

# 检查 gethostbyname_r 符号是否存在，搜索 netdb.h 头文件
check_symbol_exists("gethostbyname_r" "netdb.h" HAVE_GETHOSTBYNAME_R)
# 检查 gethostname 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("gethostname"     "${CURL_INCLUDES}" HAVE_GETHOSTNAME)  # winsock2.h unistd.h proto/bsdsocket.h

# 检查 signal 符号是否存在，搜索 signal.h 头文件
check_symbol_exists("signal"          "signal.h" HAVE_SIGNAL)
# 检查 strerror_r 符号是否存在，搜索 stdlib.h 和 string.h 头文件
check_symbol_exists("strerror_r"      "stdlib.h;string.h" HAVE_STRERROR_R)
# 检查 sigaction 符号是否存在，搜索 signal.h 头文件
check_symbol_exists("sigaction"       "signal.h" HAVE_SIGACTION)
# 检查 siginterrupt 符号是否存在，搜索 signal.h 头文件
check_symbol_exists("siginterrupt"    "signal.h" HAVE_SIGINTERRUPT)
# 检查 getaddrinfo 符号是否存在，搜索 CURL_INCLUDES、stdlib.h 和 string.h 中的头文件
check_symbol_exists("getaddrinfo"     "${CURL_INCLUDES};stdlib.h;string.h" HAVE_GETADDRINFO)  # ws2tcpip.h sys/socket.h netdb.h
# 检查 getifaddrs 符号是否存在，搜索 CURL_INCLUDES 和 stdlib.h 中的头文件
check_symbol_exists("getifaddrs"      "${CURL_INCLUDES};stdlib.h" HAVE_GETIFADDRS)  # ifaddrs.h
# 检查 freeaddrinfo 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("freeaddrinfo"    "${CURL_INCLUDES}" HAVE_FREEADDRINFO)  # ws2tcpip.h sys/socket.h netdb.h
# 检查 pipe 函数是否存在
check_function_exists("pipe"          HAVE_PIPE)
# 检查 eventfd 函数是否存在
check_function_exists("eventfd"       HAVE_EVENTFD)
# 检查 ftruncate 符号是否存在，搜索 unistd.h 头文件
check_symbol_exists("ftruncate"       "unistd.h" HAVE_FTRUNCATE)
# 检查 getpeername 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("getpeername"     "${CURL_INCLUDES}" HAVE_GETPEERNAME)  # winsock2.h unistd.h proto/bsdsocket.h
# 检查 getsockname 符号是否存在，搜索 CURL_INCLUDES 中的头文件
check_symbol_exists("getsockname"     "${CURL_INCLUDES}" HAVE_GETSOCKNAME)  # winsock2.h unistd.h proto/bsdsocket.h
# 检查 getrlimit 函数是否存在
check_function_exists("getrlimit"       HAVE_GETRLIMIT)
# 检查 setlocale 函数是否存在
check_function_exists("setlocale"       HAVE_SETLOCALE)
# 检查 setrlimit 函数是否存在
check_function_exists("setrlimit"       HAVE_SETRLIMIT)

if(NOT WIN32)
  # 若不是 Windows 平台，检查 if_nametoindex 函数是否存在
  check_function_exists("if_nametoindex"  HAVE_IF_NAMETOINDEX)  # iphlpapi.h (Windows non-UWP), net/if.h
  # 检查 realpath 函数是否存在
  check_function_exists("realpath"        HAVE_REALPATH)
  # 检查 sched_yield 函数是否存在
  check_function_exists("sched_yield"     HAVE_SCHED_YIELD)
  # 检查 strcasecmp 符号是否存在，搜索 string.h 头文件
  check_symbol_exists("strcasecmp"      "string.h" HAVE_STRCASECMP)
  # 检查 stricmp 符号是否存在，搜索 string.h 头文件
  check_symbol_exists("stricmp"         "string.h" HAVE_STRICMP)
  # 检查 strcmpi 符号是否存在，搜索 string.h 头文件
  check_symbol_exists("strcmpi"         "string.h" HAVE_STRCMPI)
endif()

if(NOT MINGW32CE)  # 避免错误检测
  # 检查 setmode 函数是否存在
  check_function_exists("setmode" HAVE_SETMODE)
  if(WIN32 OR CYGWIN)
    # 若为 Windows 或 Cygwin 平台，检查 _setmode 函数是否存在
    check_function_exists("_setmode" HAVE__SETMODE)
  endif()
endif()

if(AMIGA)
  # 若为 Amiga 平台，检查 CloseSocket 符号是否存在，搜索 CURL_INCLUDES 中的头文件
  check_symbol_exists("CloseSocket" "${CURL_INCLUDES}" HAVE_CLOSESOCKET_CAMEL)  # sys/socket.h proto/bsdsocket.h
endif()

if(NOT _ssl_enabled)
  # 若 SSL 未启用，检查 arc4random 符号是否存在，搜索 CURL_INCLUDES 和 stdlib.h 中的头文件
  check_symbol_exists("arc4random" "${CURL_INCLUDES};stdlib.h" HAVE_ARC4RANDOM)
endif()

if(NOT MSVC)
  # 若不是 MSVC 编译器，检查 snprintf 函数是否存在
  check_function_exists("snprintf" HAVE_SNPRINTF)  # 匹配 ./configure 中的检测方法
elseif(MSVC_VERSION GREATER_EQUAL 1900)  # 早期 MSVC 编译器的 snprintf 实现有问题
  # 若为 MSVC 1900 或更高版本，检查 snprintf 符号是否存在，snprintf 可能是兼容性宏，而非导出函数
  check_symbol_exists("snprintf" "stdio.h" HAVE_SNPRINTF)
endif()
if(APPLE)
  # 若为 Apple 平台，检查 mach_absolute_time 函数是否存在
  check_function_exists("mach_absolute_time" HAVE_MACH_ABSOLUTE_TIME)
endif()
if(NOT WIN32)
  # 若不是 Windows 平台，检查 inet_ntop 符号是否存在，搜索 CURL_INCLUDES、stdlib.h 和 string.h 中的头文件
  check_symbol_exists("inet_ntop" "${CURL_INCLUDES};stdlib.h;string.h" HAVE_INET_NTOP)  # arpa/inet.h netinet/in.h sys/socket.h
  # 检查 inet_pton 符号是否存在，搜索 CURL_INCLUDES、stdlib.h 和 string.h 中的头文件
  check_symbol_exists("inet_pton" "${CURL_INCLUDES};stdlib.h;string.h" HAVE_INET_PTON)  # arpa/inet.h netinet/in.h sys/socket.h
endif()

# 检查 fsetxattr 符号是否存在，搜索 sys/xattr.h 头文件
check_symbol_exists("fsetxattr" "sys/xattr.h" HAVE_FSETXATTR)
if(HAVE_FSETXATTR)
  # 若存在 fsetxattr 符号，执行自定义测试
  curl_internal_test(HAVE_FSETXATTR_5)
  curl_internal_test(HAVE_FSETXATTR_6)
endif()

# 保存当前的检查状态
cmake_push_check_state()
if(WIN32)
  # 若为 Windows 平台，将 winsock2.h 添加到额外包含文件列表中
  list(APPEND CMAKE_EXTRA_INCLUDE_FILES "winsock2.h")
  # 检查 ADDRESS_FAMILY 类型的大小
  check_type_size("ADDRESS_FAMILY" SIZEOF_ADDRESS_FAMILY)
  # 根据检查结果设置 HAVE_ADDRESS_FAMILY 变量
  set(HAVE_ADDRESS_FAMILY ${HAVE_SIZEOF_ADDRESS_FAMILY})
elseif(HAVE_SYS_SOCKET_H)
  # 若存在 sys/socket.h 头文件，将其添加到额外包含文件列表中
  list(APPEND CMAKE_EXTRA_INCLUDE_FILES "sys/socket.h")
  # 检查 sa_family_t 类型的大小
  check_type_size("sa_family_t" SIZEOF_SA_FAMILY_T)
  # 根据检查结果设置 HAVE_SA_FAMILY_T 变量
  set(HAVE_SA_FAMILY_T ${HAVE_SIZEOF_SA_FAMILY_T})
endif()
# 恢复之前保存的检查状态
cmake_pop_check_state()

# 执行 curl 特定的测试
foreach(_curl_test IN ITEMS
    HAVE_FCNTL_O_NONBLOCK
    HAVE_IOCTLSOCKET
    HAVE_IOCTLSOCKET_CAMEL
    HAVE_IOCTLSOCKET_CAMEL_FIONBIO
    HAVE_IOCTLSOCKET_FIONBIO
    HAVE_IOCTL_FIONBIO
    HAVE_IOCTL_SIOCGIFADDR
    HAVE_SETSOCKOPT_SO_NONBLOCK
    HAVE_GETHOSTBYNAME_R_3
    HAVE_GETHOSTBYNAME_R_5
    HAVE_GETHOSTBYNAME_R_6
    HAVE_BOOL_T
    STDC_HEADERS
    HAVE_ATOMIC
    )
  # 对每个测试项执行自定义测试
  curl_internal_test(${_curl_test})
endforeach()

# 检查可重入性
cmake_push_check_state()
# 添加 _REENTRANT 定义到特性检查所需的定义列表中
list(APPEND CMAKE_REQUIRED_DEFINITIONS "-D_REENTRANT")
foreach(_curl_test IN ITEMS
    HAVE_GETHOSTBYNAME_R_3
    HAVE_GETHOSTBYNAME_R_5
    HAVE_GETHOSTBYNAME_R_6)
  # 对每个测试项添加 _REENTRANT 后缀并执行自定义测试
  curl_internal_test(${_curl_test}_REENTRANT)
  if(NOT ${_curl_test} AND ${_curl_test}_REENTRANT)
    # 若原始测试失败但带 _REENTRANT 后缀的测试成功，标记需要可重入支持
    set(NEED_REENTRANT 1)
  endif()
endforeach()
# 恢复之前保存的检查状态
cmake_pop_check_state()

if(NEED_REENTRANT)
  foreach(_curl_test IN ITEMS
      HAVE_GETHOSTBYNAME_R_3
      HAVE_GETHOSTBYNAME_R_5
      HAVE_GETHOSTBYNAME_R_6)
    # 若需要可重入支持，将原始测试结果重置为 0
    set(${_curl_test} 0)
    if(${_curl_test}_REENTRANT)
      # 若带 _REENTRANT 后缀的测试成功，将原始测试结果设置为 1
      set(${_curl_test} 1)
    endif()
  endforeach()
endif()

# 保存当前的检查状态
cmake_push_check_state()
# 添加 _FILE_OFFSET_BITS=64 定义到特性检查所需的定义列表中
list(APPEND CMAKE_REQUIRED_DEFINITIONS "-D_FILE_OFFSET_BITS=64")
# 执行自定义测试检查 _FILE_OFFSET_BITS 支持
curl_internal_test(HAVE_FILE_OFFSET_BITS)
# 恢复之前保存的检查状态
cmake_pop_check_state()

# 保存当前的检查状态
cmake_push_check_state()
if(HAVE_FILE_OFFSET_BITS)
  # 若支持 _FILE_OFFSET_BITS，设置 _FILE_OFFSET_BITS 为 64
  set(_FILE_OFFSET_BITS 64)
  # 添加 _FILE_OFFSET_BITS=64 定义到特性检查所需的定义列表中
  list(APPEND CMAKE_REQUIRED_DEFINITIONS "-D_FILE_OFFSET_BITS=64")
endif()
# 检查 off_t 类型的大小
check_type_size("off_t" SIZEOF_OFF_T)

if(NOT WIN32)
  # 若不是 Windows 平台，检查 fseeko 符号是否存在，搜索 CURL_INCLUDES 和 stdio.h 中的头文件
  # fseeko 可能在 _FILE_OFFSET_BITS=64 时不存在，但在 _FILE_OFFSET_BITS 未设置或为 32 时存在
  check_symbol_exists("fseeko" "${CURL_INCLUDES};stdio.h" HAVE_FSEEKO)

  if(HAVE_FSEEKO)
    # 若存在 fseeko 符号，标记 HAVE_DECL_FSEEKO 为 1
    set(HAVE_DECL_FSEEKO 1)
  endif()
endif()

# 包含此头文件以获取类型
cmake_push_check_state()
# 将项目源目录下的 include 目录添加到特性检查所需的包含路径中
list(APPEND CMAKE_REQUIRED_INCLUDES "${PROJECT_SOURCE_DIR}/include")
# 将 curl/system.h 添加到额外包含文件列表中
list(APPEND CMAKE_EXTRA_INCLUDE_FILES "curl/system.h")
# 检查 curl_off_t 类型的大小
check_type_size("curl_off_t" SIZEOF_CURL_OFF_T)
# 将 curl/curl.h 添加到额外包含文件列表中
list(APPEND CMAKE_EXTRA_INCLUDE_FILES "curl/curl.h")
# 检查 curl_socket_t 类型的大小
check_type_size("curl_socket_t" SIZEOF_CURL_SOCKET_T)
# 恢复之前保存的检查状态，移除 curl 系统头文件
cmake_pop_check_state()  # pop curl system headers
# 恢复之前保存的检查状态，移除 -D_FILE_OFFSET_BITS=64 定义
cmake_pop_check_state()  # pop -D_FILE_OFFSET_BITS=64

if(NOT WIN32 AND NOT CMAKE_CROSSCOMPILING)
  # 若不是 Windows 平台且不是交叉编译环境，检查 argv[] 是否可写
  include(CheckCSourceRuns)
  check_c_source_runs("
    int main(int argc, char **argv)
    {
      (void)argc;
      argv[0][0] = ' ';
      return (argv[0][0] == ' ')?0:1;
    }" HAVE_WRITABLE_ARGV)
endif()

if(NOT CMAKE_CROSSCOMPILING)
  # 若不是交叉编译环境，检查 time_t 是否为无符号类型
  include(CheckCSourceRuns)
  check_c_source_runs("
    #include <time.h>
    int main(void) {
      time_t t = -1;
      return t < 0;
    }" HAVE_TIME_T_UNSIGNED)
endif()

# 执行自定义测试检查是否有 GLIBC 风格的 strerror_r
curl_internal_test(HAVE_GLIBC_STRERROR_R)
# 执行自定义测试检查是否有 POSIX 风格的 strerror_r
curl_internal_test(HAVE_POSIX_STRERROR_R)

if(NOT WIN32)
  # 若不是 Windows 平台，执行自定义测试检查是否支持 clock_gettime(CLOCK_MONOTONIC, x)
  curl_internal_test(HAVE_CLOCK_GETTIME_MONOTONIC)  # Check clock_gettime(CLOCK_MONOTONIC, x) support
endif()

if(APPLE)
  # 若为 Apple 平台，执行自定义测试检查编译器是否支持 __builtin_available()
  curl_internal_test(HAVE_BUILTIN_AVAILABLE)  # Check compiler support of __builtin_available()
endif()

# 其他一些小测试

if(_cmake_try_compile_target_type_save)
  # 若保存了编译目标类型，恢复编译目标类型并移除保存的变量
  set(CMAKE_TRY_COMPILE_TARGET_TYPE ${_cmake_try_compile_target_type_save})
  unset(_cmake_try_compile_target_type_save)
endif()

# 包含其他测试的 CMake 文件
include(CMake/OtherTests.cmake)

# 为当前目录添加 HAVE_CONFIG_H 编译定义
set_property(DIRECTORY APPEND PROPERTY COMPILE_DEFINITIONS "HAVE_CONFIG_H")

if(WIN32)
  # 若为 Windows 平台，将 Winsock 库添加到 CURL 依赖库列表中
  list(APPEND CURL_LIBS "${_win32_winsock}")
  if(NOT WINCE)
    # 若不是 Windows CE 平台，将 bcrypt 库添加到 CURL 依赖库列表中
    list(APPEND CURL_LIBS "bcrypt")
  endif()

  if(NOT WINCE)
    # 若不是 Windows CE 平台，启用 Windows 大文件支持
    set(USE_WIN32_LARGE_FILES ON)
  endif()

  # 我们使用的加密函数在 UWP 应用中不可用
  if(NOT WINDOWS_STORE)
    # 若不是 Windows Store 应用，启用 Windows 加密支持
    set(USE_WIN32_CRYPTO ON)
  endif()

  # 为 USE_WIN32_CRYPTO 或 USE_SCHANNEL 链接所需的库
  if(USE_WIN32_CRYPTO OR USE_SCHANNEL)
    if(NOT WINCE)
      # 若不是 Windows CE 平台，将 advapi32 库添加到 CURL 依赖库列表中
      list(APPEND CURL_LIBS "advapi32")
    endif()
    # 将 crypt32 库添加到 CURL 依赖库列表中
    list(APPEND CURL_LIBS "${_win32_crypt32}")
  endif()
endif()

if(CMAKE_C_COMPILER_ID STREQUAL "MSVC")  # MSVC 但排除 clang-cl
  # 若使用 MSVC 编译器，添加 -MP 选项以启用并行编译
  string(APPEND CMAKE_C_FLAGS " -MP")  # Parallel compilation
endif()

if(CURL_WERROR)
  if(MSVC)
    # 若使用 MSVC 编译器且开启 CURL_WERROR，添加 -WX 选项将警告视为错误
    string(APPEND CMAKE_C_FLAGS " -WX")
  else()
    # 若使用其他编译器且开启 CURL_WERROR，添加 -Werror 选项将警告视为错误
    string(APPEND CMAKE_C_FLAGS " -Werror")  # This assumes clang or gcc style options
  endif()
endif()

if(CURL_LTO)
  if(CMAKE_VERSION VERSION_LESS 3.9)
    # 若启用 LTO 且 CMake 版本低于 3.9，输出错误信息并终止构建
    message(FATAL_ERROR "LTO has been requested, but your cmake version ${CMAKE_VERSION} is to old. You need at least 3.9")
  endif()

  # 设置 CMake 策略
  cmake_policy(SET CMP0069 NEW)

  # 包含检查 IPO 支持的模块
  include(CheckIPOSupported)
  # 检查编译器是否支持 LTO
  check_ipo_supported(RESULT CURL_HAS_LTO OUTPUT _lto_error LANGUAGES C)
  if(CURL_HAS_LTO)
    # 若支持 LTO，输出状态信息
    message(STATUS "LTO supported and enabled")
  else()
    # 若不支持 LTO，输出错误信息并终止构建
    message(FATAL_ERROR "LTO has been requested, but the compiler does not support it\n${_lto_error}")
  endif()
endif()


# 丑陋但有效的方式来包含 "Makefile.inc"，通过转换（重新生成）它
function(curl_transform_makefile_inc _input_file _output_file)
  # 读取输入文件内容
  file(READ ${_input_file} _makefile_inc_text)
  # 将 $(top_srcdir) 替换为项目源目录
  string(REPLACE "$(top_srcdir)"   "\${PROJECT_SOURCE_DIR}" _makefile_inc_text ${_makefile_inc_text})
  # 将 $(top_builddir) 替换为项目构建目录
  string(REPLACE "$(top_builddir)" "\${PROJECT_BINARY_DIR}" _makefile_inc_text ${_makefile_inc_text})

  # 将反斜杠加换行符替换为特殊字符组合
  string(REGEX REPLACE "\\\\\n" "!π!α!" _makefile_inc_text ${_makefile_inc_text})
  # 将 Makefile 风格的变量赋值转换为 CMake 的 set 命令
  string(REGEX REPLACE "([a-zA-Z_][a-zA-Z0-9_]*)[\t ]*=[\t ]*([^\n]*)" "set(\\1 \\2)" _makefile_inc_text ${_makefile_inc_text})
  # 将特殊字符组合替换回换行符
  string(REPLACE "!π!α!" "\n" _makefile_inc_text ${_makefile_inc_text})

  # 将 $() 替换为 ${}
  string(REGEX REPLACE "\\$\\(([a-zA-Z_][a-zA-Z0-9_]*)\\)" "\${\\1}" _makefile_inc_text ${_makefile_inc_text})
  # 将 @@ 替换为 ${}，即使这可能不会被 CMake 脚本读取
  string(REGEX REPLACE "@([a-zA-Z_][a-zA-Z0-9_]*)@" "\${\\1}" _makefile_inc_text ${_makefile_inc_text})

  # 将转换后的内容写入输出文件
  file(WRITE ${_output_file} ${_makefile_inc_text})
  # 将输入文件添加为当前目录的配置依赖项
  set_property(DIRECTORY APPEND PROPERTY CMAKE_CONFIGURE_DEPENDS "${_input_file}")
endfunction()

# 包含 GNU 安装目录模块
include(GNUInstallDirs)

# 设置安装 CMake 文件的目录
set(_install_cmake_dir "${CMAKE_INSTALL_LIBDIR}/cmake/${PROJECT_NAME}")
# 设置导出目标的名称
set(TARGETS_EXPORT_NAME "${PROJECT_NAME}Targets")
# 设置生成文件的目录
set(_generated_dir "${CMAKE_CURRENT_BINARY_DIR}/generated")
# 设置项目配置文件的路径
set(_project_config "${_generated_dir}/${PROJECT_NAME}Config.cmake")
# 设置版本配置文件的路径
set(_version_config "${_generated_dir}/${PROJECT_NAME}ConfigVersion.cmake")

# 定义一个 CMake 选项，用于控制是否构建测试，默认启用
option(BUILD_TESTING "Build tests" ON)
if(BUILD_TESTING AND PERL_FOUND)
  # 若启用构建测试且找到 Perl，设置 CURL_BUILD_TESTING 为 ON
  set(CURL_BUILD_TESTING ON)
else()
  # 否则设置 CURL_BUILD_TESTING 为 OFF
  set(CURL_BUILD_TESTING OFF)
endif()

if(HAVE_MANUAL_TOOLS)
  # 若存在手动工具，设置 CURL 手册页和 ASCII 页的路径
  set(CURL_MANPAGE "${PROJECT_BINARY_DIR}/docs/cmdline-opts/curl.1")
  set(CURL_ASCIIPAGE "${PROJECT_BINARY_DIR}/docs/cmdline-opts/curl.txt")
  # 添加 docs 子目录
  add_subdirectory(docs)
endif()

# 添加 scripts 子目录，用于生成 shell 补全
add_subdirectory(scripts)

# 移除 CURL_LIBDIRS 列表中的重复项
list(REMOVE_DUPLICATES CURL_LIBDIRS)

# 添加 lib 子目录
add_subdirectory(lib)

if(BUILD_CURL_EXE)
  # 若构建 CURL 可执行文件，添加 src 子目录
  add_subdirectory(src)
endif()

# 定义一个 CMake 选项，用于控制是否构建 libcurl 示例，默认启用
option(BUILD_EXAMPLES "Build libcurl examples" ON)
if(BUILD_EXAMPLES)
  # 若启用构建示例，添加 docs/examples 子目录
  add_subdirectory(docs/examples)
endif()

if(CURL_BUILD_TESTING)
  # 若构建测试，添加 tests 子目录
  add_subdirectory(tests)
endif()

# 辅助宏，当条件满足时将标签添加到 _items 列表中
macro(curl_add_if _label)
  # 需要是宏以允许间接引用
  if(${ARGN})
    set(_items ${_items} "${_label}")
  endif()
endmacro()

# NTLM 支持需要各种 SSL 库的加密函数。
# 这些条件必须与 lib/curl_setup.h 中的条件匹配。
if(NOT CURL_DISABLE_NTLM AND
   (USE_OPENSSL OR
    USE_MBEDTLS OR
    USE_GNUTLS OR
    USE_SECTRANSP OR
    USE_WIN32_CRYPTO OR
    (USE_WOLFSSL AND HAVE_WOLFSSL_DES_ECB_ENCRYPT)))
  # 若满足条件，启用 CURL NTLM 核心支持
  set(_use_curl_ntlm_core ON)
endif()

# 清空列表并尝试检测可用的协议
set(_items "")
# 若未禁用 HTTP 协议，将 HTTP 添加到列表中
curl_add_if("HTTP"          NOT CURL_DISABLE_HTTP)
# 若未禁用 HTTP 协议且 SSL 启用，将 HTTPS 添加到列表中
curl_add_if("HTTPS"         NOT CURL_DISABLE_HTTP AND _ssl_enabled)
# 若未禁用 FTP 协议，将 FTP 添加到列表中
curl_add_if("FTP"           NOT CURL_DISABLE_FTP)
# 若未禁用 FTP 协议且 SSL 启用，将 FTPS 添加到列表中
curl_add_if("FTPS"          NOT CURL_DISABLE_FTP AND _ssl_enabled)
# 若未禁用 FILE 协议，将 FILE 添加到列表中
curl_add_if("FILE"          NOT CURL_DISABLE_FILE)
# 若未禁用 TELNET 协议，将 TELNET 添加到列表中
curl_add_if("TELNET"        NOT CURL_DISABLE_TELNET)
# 若未禁用 LDAP 协议，将 LDAP 添加到列表中
curl_add_if("LDAP"          NOT CURL_DISABLE_LDAP)
# CURL_DISABLE_LDAP 意味着 CURL_DISABLE_LDAPS
curl_add_if("LDAPS"         NOT CURL_DISABLE_LDAPS AND
                            ((USE_OPENLDAP AND _ssl_enabled) OR
                            (NOT USE_OPENLDAP AND HAVE_LDAP_SSL)))
# 若未禁用 DICT 协议，将 DICT 添加到列表中
curl_add_if("DICT"          NOT CURL_DISABLE_DICT)
# 若未禁用 TFTP 协议，将 TFTP 添加到列表中
curl_add_if("TFTP"          NOT CURL_DISABLE_TFTP)
# 若未禁用 GOPHER 协议，将 GOPHER 添加到列表中
curl_add_if("GOPHER"        NOT CURL_DISABLE_GOPHER)
# 若未禁用 GOPHER 协议且 SSL 启用，将 GOPHERS 添加到列表中
curl_add_if("GOPHERS"       NOT CURL_DISABLE_GOPHER AND _ssl_enabled)
# 若未禁用 POP3 协议，将 POP3 添加到列表中
curl_add_if("POP3"          NOT CURL_DISABLE_POP3)
# 若未禁用 POP3 协议且 SSL 启用，将 POP3S 添加到列表中
curl_add_if("POP3S"         NOT CURL_DISABLE_POP3 AND _ssl_enabled)
# 若未禁用 IMAP 协议，将 IMAP 添加到列表中
curl_add_if("IMAP"          NOT CURL_DISABLE_IMAP)
# 若未禁用 IMAP 协议且 SSL 启用，将 IMAPS 添加到列表中
curl_add_if("IMAPS"         NOT CURL_DISABLE_IMAP AND _ssl_enabled)
# 若未禁用 SMB 协议，且启用 CURL NTLM 核心支持，且 curl_off_t 大小大于 4，将 SMB 添加到列表中
curl_add_if("SMB"           NOT CURL_DISABLE_SMB AND
                            _use_curl_ntlm_core AND (SIZEOF_CURL_OFF_T GREATER 4))
# 若未禁用 SMB 协议，SSL 启用，且启用 CURL NTLM 核心支持，且 curl_off_t 大小大于 4，将 SMBS 添加到列表中
curl_add_if("SMBS"          NOT CURL_DISABLE_SMB AND _ssl_enabled AND
                            _use_curl_ntlm_core AND (SIZEOF_CURL_OFF_T GREATER 4))
# 若未禁用 SMTP 协议，将 SMTP 添加到列表中
curl_add_if("SMTP"          NOT CURL_DISABLE_SMTP)
# 若未禁用 SMTP 协议且 SSL 启用，将 SMTPS 添加到列表中
curl_add_if("SMTPS"         NOT CURL_DISABLE_SMTP AND _ssl_enabled)
# 若使用 libssh2 或 libssh 或 wolfSSH，将 SCP 添加到列表中
curl_add_if("SCP"           USE_LIBSSH2 OR USE_LIBSSH OR USE_WOLFSSH)
# 若使用 libssh2 或 libssh 或 wolfSSH，将 SFTP 添加到列表中
curl_add_if("SFTP"          USE_LIBSSH2 OR USE_LIBSSH OR USE_WOLFSSH)
# 若未禁用 IPFS 协议，将 IPFS 添加到列表中
curl_add_if("IPFS"          NOT CURL_DISABLE_IPFS)
# 若未禁用 IPFS 协议，将 IPNS 添加到列表中
curl_add_if("IPNS"          NOT CURL_DISABLE_IPFS)
# 若未禁用 RTSP 协议，将 RTSP 添加到列表中
curl_add_if("RTSP"          NOT CURL_DISABLE_RTSP)
# 若使用 librtmp，将 RTMP 添加到列表中
curl_add_if("RTMP"          USE_LIBRTMP)
# 若未禁用 MQTT 协议，将 MQTT 添加到列表中
curl_add_if("MQTT"          NOT CURL_DISABLE_MQTT)
# 若未禁用 WebSocket 协议，将 WS 添加到列表中
curl_add_if("WS"            NOT CURL_DISABLE_WEBSOCKETS)
# 若未禁用 WebSocket 协议且 SSL 启用，将 WSS 添加到列表中
curl_add_if("WSS"           NOT CURL_DISABLE_WEBSOCKETS AND _ssl_enabled)
if(_items)
  # 若列表不为空，对列表进行排序
  list(SORT _items)
endif()
# 设置 CURL 支持的协议列表
set(CURL_SUPPORTED_PROTOCOLS_LIST "${_items}")
# 将列表中的元素用空格连接成字符串
string(REPLACE ";" " " SUPPORT_PROTOCOLS "${_items}")
# 将支持协议字符串转换为小写
string(TOLOWER "${SUPPORT_PROTOCOLS}" _support_protocols_lower)
# 输出支持的协议信息
message(STATUS "Protocols: ${_support_protocols_lower}")

# 清空列表并尝试检测可用的特性
set(_items "")
# 若 SSL 启用，将 SSL 添加到列表中
curl_add_if("SSL"           _ssl_enabled)
# 若启用 IPv6 支持，将 IPv6 添加到列表中
curl_add_if("IPv6"          USE_IPV6)
# 若启用 Unix 域套接字支持，将 UnixSockets 添加到列表中
curl_add_if("UnixSockets"   USE_UNIX_SOCKETS)
# 若存在 libz 库，将 libz 添加到列表中
curl_add_if("libz"          HAVE_LIBZ)
# 若存在 brotli 库，将 brotli 添加到列表中
curl_add_if("brotli"        HAVE_BROTLI)
# 若使用 libgsasl，将 gsasl 添加到列表中
curl_add_if("gsasl"         USE_GSASL)
# 若存在 zstd 库，将 zstd 添加到列表中
curl_add_if("zstd"          HAVE_ZSTD)
# 若使用 c-ares 或 POSIX 线程或 Windows 线程，将 AsynchDNS 添加到列表中
curl_add_if("AsynchDNS"     USE_ARES OR USE_THREADS_POSIX OR USE_THREADS_WIN32)
# 若使用 c-ares 且启用线程解析器且启用 HTTPSRR，将 asyn-rr 添加到列表中
curl_add_if("asyn-rr"       USE_ARES AND ENABLE_THREADED_RESOLVER AND USE_HTTPSRR)
# 若存在 libidn2 库且找到 idn2.h 头文件，或使用 WinIDN，或使用 Apple 内置 IDN 支持，将 IDN 添加到列表中
curl_add_if("IDN"           (HAVE_LIBIDN2 AND HAVE_IDN2_H) OR
                            USE_WIN32_IDN OR
                            USE_APPLE_IDN)
# 若 curl_off_t 大小大于 4，且 off_t 大小大于 4 或启用 Windows 大文件支持，将 Largefile 添加到列表中
curl_add_if("Largefile"     (SIZEOF_CURL_OFF_T GREATER 4) AND
                            ((SIZEOF_OFF_T GREATER 4) OR USE_WIN32_LARGE_FILES))
# 若使用 Windows SSPI，将 SSPI 添加到列表中
curl_add_if("SSPI"          USE_WINDOWS_SSPI)
# 若存在 GSSAPI 库，将 GSS-API 添加到列表中
curl_add_if("GSS-API"       HAVE_GSSAPI)
# 若未禁用 Alt-Svc 支持，将 alt-svc 添加到列表中
curl_add_if("alt-svc"       NOT CURL_DISABLE_ALTSVC)
# 若未禁用 HSTS 支持，将 HSTS 添加到列表中
curl_add_if("HSTS"          NOT CURL_DISABLE_HSTS)
# 若未禁用协商认证且存在 GSSAPI 库或使用 Windows SSPI，将 SPNEGO 添加到列表中
curl_add_if("SPNEGO"        NOT CURL_DISABLE_NEGOTIATE_AUTH AND
                            (HAVE_GSSAPI OR USE_WINDOWS_SSPI))
# 若未禁用 Kerberos 认证且存在 GSSAPI 库或使用 Windows SSPI，将 Kerberos 添加到列表中
curl_add_if("Kerberos"      NOT CURL_DISABLE_KERBEROS_AUTH AND
                            (HAVE_GSSAPI OR USE_WINDOWS_SSPI))
# 若未禁用 NTLM 认证且启用 CURL NTLM 核心支持或使用 Windows SSPI，将 NTLM 添加到列表中
curl_add_if("NTLM"          NOT CURL_DISABLE_NTLM AND
                            (_use_curl_ntlm_core OR USE_WINDOWS_SSPI))
# 若启用 TLS SRP 支持，将 TLS-SRP 添加到列表中
curl_add_if("TLS-SRP"       USE_TLS_SRP)
# 若使用 nghttp2，将 HTTP2 添加到列表中
curl_add_if("HTTP2"         USE_NGHTTP2)
# 若使用 ngtcp2 或 quiche 或 msh3/msquic 或 OpenSSL QUIC 支持，将 HTTP3 添加到列表中
curl_add_if("HTTP3"         USE_NGTCP2 OR USE_QUICHE OR USE_MSH3 OR USE_OPENSSL_QUIC)
# 若启用多 SSL 支持，将 MultiSSL 添加到列表中
curl_add_if("MultiSSL"      CURL_WITH_MULTI_SSL)
# 若未禁用代理且 SSL 启用，且使用 OpenSSL 或 GnuTLS 或 Schannel 或 Rustls 或 BearSSL 或 mbedTLS 或 Sectransp 或 (使用 wolfSSL 且存在 wolfSSL BIO)，将 HTTPS-proxy 添加到列表中
curl_add_if("HTTPS-proxy"   NOT CURL_DISABLE_PROXY AND _ssl_enabled AND (USE_OPENSSL OR USE_GNUTLS
                            OR USE_SCHANNEL OR USE_RUSTLS OR USE_BEARSSL OR
                            USE_MBEDTLS OR USE_SECTRANSP OR
                            (USE_WOLFSSL AND HAVE_WOLFSSL_BIO)))
# 若启用 Unicode 支持，将 Unicode 添加到列表中
curl_add_if("Unicode"       ENABLE_UNICODE)
# 若存在原子操作支持，或使用 POSIX 线程且存在 pthread.h 头文件，或为 Windows 平台且 Windows 版本不低于 Windows Vista，将 threadsafe 添加到列表中
curl_add_if("threadsafe"    HAVE_ATOMIC OR
                            (USE_THREADS_POSIX AND HAVE_PTHREAD_H) OR
                            (WIN32 AND HAVE_WIN32_WINNT GREATER_EQUAL 0x0600))
# 若启用调试支持，将 Debug 添加到列表中
curl_add_if("Debug"         ENABLE_DEBUG)
# 若启用 CURL 调试，将 TrackMemory 添加到列表中
curl_add_if("TrackMemory"   ENABLE_CURLDEBUG)
# 若 SSL 启用且存在 ECH 支持，将 ECH 添加到列表中
curl_add_if("ECH"           _ssl_enabled AND HAVE_ECH)
# 若 SSL 启用且启用 HTTPSRR，将 HTTPSRR 添加到列表中
curl_add_if("HTTPSRR"       _ssl_enabled AND USE_HTTPSRR)
# 若使用 libpsl，将 PSL 添加到列表中
curl_add_if("PSL"           USE_LIBPSL)
# 若设置了要嵌入的 CA 证书包，将 CAcert 添加到列表中
curl_add_if("CAcert"        CURL_CA_EMBED_SET)
# 若 SSL 启用且启用 SSLS 导出，将 SSLS-EXPORT 添加到列表中
curl_add_if("SSLS-EXPORT"   _ssl_enabled AND USE_SSLS_EXPORT)
if(_items)
  if(NOT CMAKE_VERSION VERSION_LESS 3.13)
    # 若 CMake 版本不低于 3.13，对列表进行不区分大小写的排序
    list(SORT _items CASE INSENSITIVE)
  else()
    # 否则对列表进行排序
    list(SORT _items)
  endif()
endif()
# 设置 CURL 支持的特性列表
set(CURL_SUPPORTED_FEATURES_LIST "${_items}")
# 将列表中的元素用空格连接成字符串
string(REPLACE ";" " " SUPPORT_FEATURES "${_items}")
# 输出支持的特性信息
message(STATUS "Features: ${SUPPORT_FEATURES}")

# 清空列表并收集启用的 SSL 后端
set(_items "")
# 若 SSL 启用且使用 Schannel，将 Schannel 添加到列表中
curl_add_if("Schannel"         _ssl_enabled AND USE_SCHANNEL)
# 若 SSL 启用且使用 OpenSSL 且 OpenSSL 版本低于 3.0.0，将 OpenSSL 版本信息添加到列表中
curl_add_if("${_openssl}"      _ssl_enabled AND USE_OPENSSL AND OPENSSL_VERSION VERSION_LESS 3.0.0)
# 若 SSL 启用且使用 OpenSSL 且 OpenSSL 版本不低于 3.0.0，将 OpenSSL v3+ 信息添加到列表中
curl_add_if("${_openssl} v3+"  _ssl_enabled AND USE_OPENSSL AND NOT OPENSSL_VERSION VERSION_LESS 3.0.0)
# 若 SSL 启用且使用 Secure Transport，将 Secure Transport 添加到列表中
curl_add_if("Secure Transport" _ssl_enabled AND USE_SECTRANSP)
# 若 SSL 启用且使用 mbedTLS，将 mbedTLS 添加到列表中
curl_add_if("mbedTLS"          _ssl_enabled AND USE_MBEDTLS)
# 若 SSL 启用且使用 BearSSL，将 BearSSL 添加到列表中
curl_add_if("BearSSL"          _ssl_enabled AND USE_BEARSSL)
# 若 SSL 启用且使用 wolfSSL，将 wolfSSL 添加到列表中
curl_add_if("wolfSSL"          _ssl_enabled AND USE_WOLFSSL)
# 若 SSL 启用且使用 GnuTLS，将 GnuTLS 添加到列表中
curl_add_if("GnuTLS"           _ssl_enabled AND USE_GNUTLS)
# 若 SSL 启用且使用 rustls，将 rustls 添加到列表中
curl_add_if("rustls"           _ssl_enabled AND USE_RUSTLS)

if(_items)
  if(NOT CMAKE_VERSION VERSION_LESS 3.13)
    # 若 CMake 版本不低于 3.13，对列表进行不区分大小写的排序
    list(SORT _items CASE INSENSITIVE)
  else()
    # 否则对列表进行排序
    list(SORT _items)
  endif()
endif()
# 将列表中的元素用空格连接成字符串
string(REPLACE ";" " " SSL_BACKENDS "${_items}")
# 输出启用的 SSL 后端信息
message(STATUS "Enabled SSL backends: ${SSL_BACKENDS}")
if(CURL_DEFAULT_SSL_BACKEND)
  # 若设置了默认 SSL 后端，输出默认 SSL 后端信息
  message(STATUS "Default SSL backend: ${CURL_DEFAULT_SSL_BACKEND}")
endif()

if(NOT CURL_DISABLE_INSTALL)

  # curl-config 需要设置以下选项。
  # 设置 C 编译器
  set(CC                      "${CMAKE_C_COMPILER}")
  # 设置配置选项
  set(CONFIGURE_OPTIONS       "")
  # 设置 CURL 版本号
  set(CURLVERSION             "${_curl_version}")
  # 设置 CURL 版本号的数值形式
  set(VERSIONNUM              "${_curl_version_num}")
  # 设置安装前缀
  set(prefix                  "${CMAKE_INSTALL_PREFIX}")
  # 设置可执行文件安装前缀
  set(exec_prefix             "\${prefix}")
  if(IS_ABSOLUTE ${CMAKE_INSTALL_INCLUDEDIR})
    # 若包含目录为绝对路径，直接设置包含目录
    set(includedir            "${CMAKE_INSTALL_INCLUDEDIR}")
  else()
    # 否则设置包含目录为前缀加上包含目录
    set(includedir            "\${prefix}/${CMAKE_INSTALL_INCLUDEDIR}")
  endif()
  if(IS_ABSOLUTE ${CMAKE_INSTALL_LIBDIR})
    # 若库目录为绝对路径，直接设置库目录
    set(libdir                "${CMAKE_INSTALL_LIBDIR}")
  else()
    # 否则设置库目录为可执行文件安装前缀加上库目录
    set(libdir                "\${exec_prefix}/${CMAKE_INSTALL_LIBDIR}")
  endif()
  # 获取静态库后缀，去除点号
  string(REPLACE "." "" libext "${CMAKE_STATIC_LIBRARY_SUFFIX}")

  # 初始化链接标志
  set(_ldflags "")
  # 初始化 libcurl.pc 中的私有库信息
  set(LIBCURL_PC_LIBS_PRIVATE "")

  # 过滤 CMAKE_SHARED_LINKER_FLAGS 中的库和库路径
  string(STRIP "${CMAKE_SHARED_LINKER_FLAGS}" _custom_ldflags)
  string(REGEX REPLACE " +-([^ \\t;]*)" ";-\\1" _custom_ldflags "${_custom_ldflags}")

  # 初始化自定义库列表
  set(_custom_libs "")
  # 初始化自定义库路径列表
  set(_custom_libdirs "")
  foreach(_flag IN LISTS _custom_ldflags)
    if(_flag MATCHES "^-l")
      # 若标志以 -l 开头，提取库名并添加到自定义库列表中
      string(REGEX REPLACE "^-l" "" _flag "${_flag}")
      list(APPEND _custom_libs "${_flag}")
    elseif(_flag MATCHES "^-framework|^-F")
      # 若标志为 -framework 或 -F，添加到自定义库列表中
      list(APPEND _custom_libs "${_flag}")
    elseif(_flag MATCHES "^-L")
      # 若标志以 -L 开头，提取库路径并添加到自定义库路径列表中
      string(REGEX REPLACE "^-L" "" _flag "${_flag}")
      list(APPEND _custom_libdirs "${_flag}")
    elseif(_flag MATCHES "^--library-path=")
      # 若标志为 --library-path=，提取库路径并添加到自定义库路径列表中
      string(REGEX REPLACE "^--library-path=" "" _flag "${_flag}")
      list(APPEND _custom_libdirs "${_flag}")
    endif()
  endforeach()

  # 避免为已知系统目录添加不必要的 -L 选项。
  # 获取系统隐含的链接目录
  set(_sys_libdirs "${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}")
  foreach(_libdir IN LISTS CMAKE_SYSTEM_PREFIX_PATH)
    if(_libdir MATCHES "/$")
      # 若路径以斜杠结尾，添加 lib 目录
      string(APPEND _libdir "lib")
    else()
      # 否则添加 /lib 目录
      string(APPEND _libdir "/lib")
    endif()
    if(IS_DIRECTORY "${_libdir}")
      # 若目录存在，添加到系统库目录列表中
      list(APPEND _sys_libdirs "${_libdir}")
    endif()
    if(DEFINED CMAKE_LIBRARY_ARCHITECTURE)
      # 若定义了库架构，添加对应的架构目录
      string(APPEND _libdir "/${CMAKE_LIBRARY_ARCHITECTURE}")
      if(IS_DIRECTORY "${_libdir}")
        # 若目录存在，添加到系统库目录列表中
        list(APPEND _sys_libdirs "${_libdir}")
      endif()
    endif()
  endforeach()

  foreach(_libdir IN LISTS _custom_libdirs CURL_LIBDIRS)
    if(NOT CMAKE_VERSION VERSION_LESS 3.20)
      # 若 CMake 版本不低于 3.20，对库路径进行规范化处理
      cmake_path(SET _libdir NORMALIZE "${_libdir}")
    endif()
    # 查找库路径是否在系统库目录列表中
    list(FIND _sys_libdirs "${_libdir}" _libdir_index)
    if(_libdir_index LESS 0)
      # 若不在系统库目录列表中，添加 -L 选项到链接标志中
      list(APPEND _ldflags "-L${_libdir}")
    endif()
  endforeach()

  # 初始化隐含库列表
  set(_implicit_libs "")
  if(NOT MINGW AND NOT UNIX)
    # 若不是 MinGW 且不是 Unix 平台，获取系统隐含的链接库
    set(_implicit_libs "${CMAKE_C_IMPLICIT_LINK_LIBRARIES}")
  endif()

  foreach(_lib IN LISTS _implicit_libs _custom_libs CURL_LIBS)
    if(TARGET "${_lib}")
      # 若 _lib 是一个目标，获取目标名称
      set(_libname "${_lib}")
      # 获取目标是否为导入目标
      get_target_property(_imported "${_libname}" IMPORTED)
      if(NOT _imported)
        # 若不是导入目标，读取 LOCATION 属性会出错，跳过该目标
        continue()
      endif()
      # 获取目标的位置
      get_target_property(_lib "${_libname}" LOCATION)
      if(NOT _lib)
        # 若未获取到目标位置，输出警告信息并跳过
        message(WARNING "Bad lib in library list: ${_libname}")
        continue()
      endif()
    endif()
    if(_lib MATCHES "^-")  # '-framework <name>'
      # 若 _lib 以 - 开头，添加到链接标志中
      list(APPEND _ldflags "${_lib}")
    elseif(_lib MATCHES "/")
      # 若 _lib 包含路径，提取库目录和库名
      get_filename_component(_libdir ${_lib} DIRECTORY)
      get_filename_component(_libname ${_lib} NAME_WE)
      if(_libname MATCHES "^lib")
        if(NOT CMAKE_VERSION VERSION_LESS 3.20)
          # 若 CMake 版本不低于 3.20，对库目录进行规范化处理
          cmake_path(SET _libdir NORMALIZE "${_libdir}")
        endif()
        # 查找库目录是否在系统库目录列表中
        list(FIND _sys_libdirs "${_libdir}" _libdir_index)
        if(_libdir_index LESS 0)
          # 若不在系统库目录列表中，添加 -L 选项到链接标志中
          list(APPEND _ldflags "-L${_libdir}")
        endif()
        # 去除库名的 lib 前缀
        string(REGEX REPLACE "^lib" "" _libname "${_libname}")
        # 添加 -l 选项到 libcurl.pc 中的私有库信息中
        list(APPEND LIBCURL_PC_LIBS_PRIVATE "-l${_libname}")
      else()
        # 若库名不以 lib 开头，直接添加到 libcurl.pc 中的私有库信息中
        list(APPEND LIBCURL_PC_LIBS_PRIVATE "${_lib}")
      endif()
    else()
      # 若 _lib 不包含路径，添加 -l 选项到 libcurl.pc 中的私有库信息中
      list(APPEND LIBCURL_PC_LIBS_PRIVATE "-l${_lib}")
    endif()
  endforeach()

  if(LIBCURL_PC_REQUIRES_PRIVATE)
    # 若 libcurl.pc 中的私有依赖项存在，将列表元素用逗号连接
    string(REPLACE ";" "," LIBCURL_PC_REQUIRES_PRIVATE "${LIBCURL_PC_REQUIRES_PRIVATE}")
  endif()
  if(LIBCURL_PC_LIBS_PRIVATE)
    # 若 libcurl.pc 中的私有库信息存在，将列表元素用空格连接
    string(REPLACE ";" " " LIBCURL_PC_LIBS_PRIVATE "${LIBCURL_PC_LIBS_PRIVATE}")
  endif()
  if(_ldflags)
    # 若链接标志存在，移除重复项，将列表元素用空格连接，并设置为 libcurl.pc 中的私有链接标志
    list(REMOVE_DUPLICATES _ldflags)
    string(REPLACE ";" " " _ldflags "${_ldflags}")
    set(LIBCURL_PC_LDFLAGS_PRIVATE "${_ldflags}")
    string(STRIP "${LIBCURL_PC_LDFLAGS_PRIVATE}" LIBCURL_PC_LDFLAGS_PRIVATE)
  else()
    # 若链接标志不存在，设置 libcurl.pc 中的私有链接标志为空
    set(LIBCURL_PC_LDFLAGS_PRIVATE "")
  endif()
  # 设置 libcurl.pc 中的私有编译标志
  set(LIBCURL_PC_CFLAGS_PRIVATE "-DCURL_STATICLIB")

  # 当仅构建静态库时，将 pkg-config 私有字段合并到公共字段中
  if(BUILD_SHARED_LIBS)
    # 若构建共享库，设置共享库启用标志
    set(ENABLE_SHARED       "yes")
    # 设置 libcurl.pc 中的公共依赖项为空
    set(LIBCURL_PC_REQUIRES "")
    # 设置 libcurl.pc 中的公共库信息为空
    set(LIBCURL_PC_LIBS     "")
    # 设置 libcurl.pc 中的公共编译标志为空
    set(LIBCURL_PC_CFLAGS   "")
  else()
    # 若不构建共享库，设置共享库禁用标志
    set(ENABLE_SHARED       "no")
    # 设置 libcurl.pc 中的公共依赖项为私有依赖项
    set(LIBCURL_PC_REQUIRES "${LIBCURL_PC_REQUIRES_PRIVATE}")
    # 设置 libcurl.pc 中的公共库信息为私有库信息
    set(LIBCURL_PC_LIBS     "${LIBCURL_PC_LIBS_PRIVATE}")
    # 设置 libcurl.pc 中的公共编译标志为私有编译标志
    set(LIBCURL_PC_CFLAGS   "${LIBCURL_PC_CFLAGS_PRIVATE}")
  endif()
  if(BUILD_STATIC_LIBS)
    # 若构建静态库，设置静态库启用标志
    set(ENABLE_STATIC       "yes")
  else()
    # 若不构建静态库，设置静态库禁用标志
    set(ENABLE_STATIC       "no")
  endif()

  # 生成匹配此配置的 "curl-config" 文件。
  # 消耗的变量：
  #   CC
  #   CONFIGURE_OPTIONS
  #   CURLVERSION
  #   CURL_CA_BUNDLE
  #   ENABLE_SHARED
  #   ENABLE_STATIC
  #   exec_prefix
  #   includedir
  #   LIBCURL_PC_CFLAGS
  #   LIBCURL_PC_LDFLAGS_PRIVATE
  #   LIBCURL_PC_LIBS_PRIVATE
  #   libdir
  #   libext
  #   prefix
  #   SSL_BACKENDS
  #   SUPPORT_FEATURES
  #   SUPPORT_PROTOCOLS
  #   VERSIONNUM
  configure_file(
    "${PROJECT_SOURCE_DIR}/curl-config.in"
    "${PROJECT_BINARY_DIR}/curl-config" @ONLY)
  # 安装生成的 curl-config 文件
  install(FILES "${PROJECT_BINARY_DIR}/curl-config"
    DESTINATION ${CMAKE_INSTALL_BINDIR}
    PERMISSIONS
      OWNER_READ OWNER_WRITE OWNER_EXECUTE
      GROUP_READ GROUP_EXECUTE
      WORLD_READ WORLD_EXECUTE)

  # 生成匹配此配置的 pkg-config 文件。
  # 消耗的变量：
  #   CURLVERSION
  #   exec_prefix
  #   includedir
  #   LIBCURL_PC_CFLAGS
  #   LIBCURL_PC_CFLAGS_PRIVATE
  #   LIBCURL_PC_LDFLAGS_PRIVATE
  #   LIBCURL_PC_LIBS
  #   LIBCURL_PC_LIBS_PRIVATE
  #   LIBCURL_PC_REQUIRES
  #   LIBCURL_PC_REQUIRES_PRIVATE
  #   libdir
  #   prefix
  #   SUPPORT_FEATURES
  #   SUPPORT_PROTOCOLS
  # 文档：
  #   https://people.freedesktop.org/~dbn/pkg-config-guide.html
  #   https://manpages.debian.org/unstable/pkgconf/pkg-config.1.en.html
  #   https://manpages.debian.org/unstable/pkg-config/pkg-config.1.en.html
  #   https://www.msys2.org/docs/pkgconfig/
  configure_file(
    "${PROJECT_SOURCE_DIR}/libcurl.pc.in"
    "${PROJECT_BINARY_DIR}/libcurl.pc" @ONLY)
  # 安装生成的 libcurl.pc 文件
  install(FILES "${PROJECT_BINARY_DIR}/libcurl.pc"
    DESTINATION "${CMAKE_INSTALL_LIBDIR}/pkgconfig")

  # 安装头文件
  install(DIRECTORY "${PROJECT_SOURCE_DIR}/include/curl"
    DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
    FILES_MATCHING PATTERN "*.h")

  # 包含 CMake 包配置帮助模块
  include(CMakePackageConfigHelpers)
  # 生成基本的包版本文件
  write_basic_package_version_file(
    "${_version_config}"
    VERSION ${_curl_version}
    COMPATIBILITY SameMajorVersion)
  # 读取生成的版本配置文件内容
  file(READ "${_version_config}" _generated_version_config)
  # 在版本配置文件开头添加兼容性处理代码
  file(WRITE "${_version_config}" "
    if(NOT PACKAGE_FIND_VERSION_RANGE AND PACKAGE_FIND_VERSION_MAJOR STREQUAL \"7\")
      # Version 8 satisfies version 7... requirements
      set(PACKAGE_FIND_VERSION_MAJOR 8)
      set(PACKAGE_FIND_VERSION_COUNT 1)
    endif()
    ${_generated_version_config}")

  # 生成项目配置文件
  # 消耗的自定义变量：
  #   CURLVERSION
  #   LIB_SELECTED
  #   TARGETS_EXPORT_NAME
  #   USE_OPENSSL OPENSSL_VERSION_MAJOR
  #   HAVE_LIBZ ZLIB_VERSION_MAJOR
  #   CURL_SUPPORTED_FEATURES_LIST
  #   CURL_SUPPORTED_PROTOCOLS_LIST
  configure_package_config_file("CMake/curl-config.cmake.in"
    "${_project_config}"
    INSTALL_DESTINATION ${_install_cmake_dir}
    PATH_VARS CMAKE_INSTALL_INCLUDEDIR)

  if(CURL_ENABLE_EXPORT_TARGET)
    # 若启用导出目标，安装导出的目标
    install(EXPORT "${TARGETS_EXPORT_NAME}"
      NAMESPACE "${PROJECT_NAME}::"
      DESTINATION ${_install_cmake_dir})
  endif()

  # 安装版本配置文件和项目配置文件
  install(FILES ${_version_config} ${_project_config}
    DESTINATION ${_install_cmake_dir})

  if(NOT TARGET curl_uninstall)
    # 若不存在 curl_uninstall 目标，生成卸载脚本
    configure_file(
      "${CMAKE_CURRENT_SOURCE_DIR}/CMake/cmake_uninstall.cmake.in"
      "${CMAKE_CURRENT_BINARY_DIR}/CMake/cmake_uninstall.cmake"
      @ONLY)

    # 添加 curl_uninstall 自定义目标
    add_custom_target(curl_uninstall
      COMMAND ${CMAKE_COMMAND} -P "${CMAKE_CURRENT_BINARY_DIR}/CMake/cmake_uninstall.cmake")
  endif()

  # 安装 mk-ca-bundle.pl 脚本
  install(FILES "${PROJECT_SOURCE_DIR}/scripts/mk-ca-bundle.pl"
    DESTINATION ${CMAKE_INSTALL_BINDIR}
    PERMISSIONS
      OWNER_READ OWNER_WRITE OWNER_EXECUTE
      GROUP_READ GROUP_EXECUTE
      WORLD_READ WORLD_EXECUTE)

  # 提取版本号中的补丁部分，'-DEV' 部分很重要
  string(REGEX REPLACE "([0-9]+\.[0-9]+)\.([0-9]+.*)" "\\2" CPACK_PACKAGE_VERSION_PATCH "${_curl_version}")
  # 设置 CPack 生成器为 TGZ
  set(CPACK_GENERATOR "TGZ")
  # 包含 CPack 模块
  include(CPack)
endif()

# 保存构建信息供测试运行器拾取并记录
set(_cmake_sysroot "")
if(CMAKE_OSX_SYSROOT)
  # 若设置了 OSX 系统根目录，设置 _cmake_sysroot 为该目录
  set(_cmake_sysroot ${CMAKE_OSX_SYSROOT})
elseif(CMAKE_SYSROOT)
  # 若设置了系统根目录，设置 _cmake_sysroot 为该目录
  set(_cmake_sysroot ${CMAKE_SYSROOT})
endif()
# 构建构建信息字符串
set(_buildinfo "\
buildinfo.configure.tool: cmake
buildinfo.configure.command: ${CMAKE_COMMAND}
buildinfo.configure.version: ${CMAKE_VERSION}
buildinfo.configure.args:${_cmake_args}
buildinfo.configure.generator: ${CMAKE_GENERATOR}
buildinfo.configure.make: ${CMAKE_MAKE_PROGRAM}
buildinfo.host.cpu: ${CMAKE_HOST_SYSTEM_PROCESSOR}
buildinfo.host.os: ${CMAKE_HOST_SYSTEM_NAME}
buildinfo.target.cpu: ${CMAKE_SYSTEM_PROCESSOR}
buildinfo.target.os: ${CMAKE_SYSTEM_NAME}
buildinfo.target.flags:${_target_flags}
buildinfo.compiler: ${CMAKE_C_COMPILER_ID}
buildinfo.compiler.version: ${CMAKE_C_COMPILER_VERSION}
buildinfo.sysroot: ${_cmake_sysroot}
")
# 将构建信息写入 buildinfo.txt 文件
file(WRITE "${PROJECT_BINARY_DIR}/buildinfo.txt" "# This is a generated file.  Do not edit.\n${_buildinfo}")
if(NOT "$ENV{CURL_BUILDINFO}$ENV{CURL_CI}$ENV{CI}" STREQUAL "")
  # 若设置了相关环境变量，输出构建信息
  message(STATUS "\n${_buildinfo}")
endif()
